從 VMware Cloud Director 10.4.1 開始，可以使用 VMware Cloud Director API 將個別使用者從一個身分識別提供者 (IDP) 重新對應到另一個身分識別提供者 (IDP)。

重要： 請勿將使用者移轉到系統組織 LDAP 組態或從系統組織 LDAP 組態中移轉使用者。從系統組織 LDAP 組態移轉的使用者無法登入除執行移轉的組織以外的任何組織。如需詳細資訊，請參閱 VMware Cloud Director 10.4.2 版本說明中的「已知問題」一節。
備註： 從版本 10.4.1 開始， VMware Cloud Director 開始棄用本機使用者。 VMware Cloud Director 在本機使用者棄用時繼續完全支援使用這些本機使用者。請參閱 VMware Cloud Director 10.4.1 版本說明。

如需在版本 10.4.2 中使用 VMware Cloud Director 使用者介面在身分識別提供者之間大量重新對應使用者的相關資訊，請參閱在 VMware Cloud Director 10.4.2 及更新版本中，在身分識別提供者之間重新對應使用者。

必要條件

  • 確認您的角色包括群組/使用者：管理權限。
  • 確認組織設定了要在其間重新對應的身分識別提供者類型。

程序

  1. 向 /cloudapi/1.0.0/users 發出 GET 要求。

    VMware Cloud Director 傳回組織內的使用者清單。

  2. 找到要重新對應的使用者，然後擷取使用者資訊。 
    GET /cloudapi/1.0.0/users/{user_id}
  3. 向 /cloudapi/1.0.0/users/{user_id} 發出 PUT 要求。

    若要重新對應使用者，必須變更 providerType 欄位以識別新的 IDP。VMware Cloud Director 支援 SAML、LDAP、OAUTH 和 LOCAL 值。此外，為了符合使用者重新對應到的 IDP 中的使用者名稱，可以修改使用者名稱。使用者透過新的登入流程登入時，如果 VMware Cloud Director 要繼續將使用者的資產與使用者關聯，則使用者的識別碼必須保持不變。

    重要：

    如果要重新對應到提供者類型 LDAP，VMware Cloud Director 會在交付作業之前透過 LDAP 伺服器驗證使用者名稱。如果 VMware Cloud Director 因任何原因 (例如，與 LDAP 伺服器的連線中斷) 而未完成此步驟，則重新對應將失敗。

    如果要透過指定提供者類型 LOCAL 將使用者重新對應為本機使用者，與建立使用者的程序類似，必須提供密碼。

  4. 驗證 VMware Cloud Director 是否傳回 OK 回應，在回應本文中指定了新重新對應的提供者類型。

範例：

若要尋找要重新對應的使用者，請發出以下要求。

要求： 
GET /cloudapi/1.0.0/users?pageSize=10 HTTP/1.1
Host: 127.0.0.1:8443
Accept: application/json;version=37.1
範例回應： 
{
  "resultTotal": 2,
  "pageCount": 1,
  "page": 1,
  "pageSize": 10,
  "associations": null,
  "values": [
    ...,
    {
      "username": "testuser",
      "fullName": "",
      "description": null,
      "id": "urn:vcloud:user:2b038199-0063-4c13-9bba-a3b58d775785",
      "roleEntityRefs": [
        {
          "name": "vApp Author",
          "id": "urn:vcloud:role:85f69506-52a5-3e20-869a-ea18d667e19e"
        }
      ],
      "orgEntityRef": {
        "name": "testorg",
        "id": "urn:vcloud:org:806f0d87-c8b9-47f5-bfbe-3dc73a4c0d14"
      },
      "password": "******",
      "email": "",
      "nameInSource": "testuser",
      "enabled": true,
      "isGroupRole": false,
      "providerType": "LOCAL"
    }
  ]
}

若要將 testuser 從 LOCAL 重新對應到 LDAP，請發出 PUT 要求。

要求： 
PUT /cloudapi/1.0.0/users/urn:vcloud:user:2b038199-0063-4c13-9bba-a3b58d775785 HTTP/1.1
Host: 127.0.0.1:8443
Accept: application/json;version=37.1
Content-Type: application/json;version=37.1

Body: {
  "username": "testuser",
  "fullName": "",
  "description": null,
  "id": "urn:vcloud:user:2b038199-0063-4c13-9bba-a3b58d775785",
  "roleEntityRefs": [
    {
      "name": "vApp Author",
      "id": "urn:vcloud:role:85f69506-52a5-3e20-869a-ea18d667e19e"
    }
  ],
  "orgEntityRef": {
    "name": "testorg",
    "id": "urn:vcloud:org:806f0d87-c8b9-47f5-bfbe-3dc73a4c0d14"
  },
  "password": "******",
  "email": "",
  "nameInSource": "testuser",
  "enabled": true,
  "isGroupRole": false,
  "providerType": "LDAP"
}
範例回應： 
{
  "username": "testuser",
  "fullName": "",
  "description": null,
  "id": "urn:vcloud:user:2b038199-0063-4c13-9bba-a3b58d775785",
  "roleEntityRefs": [
    {
      "name": "vApp Author",
      "id": "urn:vcloud:role:85f69506-52a5-3e20-869a-ea18d667e19e"
    }
  ],
  "orgEntityRef": {
    "name": "testorg",
    "id": "urn:vcloud:org:806f0d87-c8b9-47f5-bfbe-3dc73a4c0d14"
  },
  "password": null,
  "email": "",
  "nameInSource": "\\63\\36\\62\\35\\30\\66\\35\\63\\2D\\61\\62\\30\\35\\2D\\34\\37\\64\\33\\2D\\62\\61\\64\\34\\2D\\39\\32\\64\\35\\32\\37\\30\\36\\62\\39\\39\\33",
  "enabled": true,
  "isGroupRole": false,
  "providerType": "LDAP"
}