LDAP

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。 不過，如果連接器不支援任何實體作業，系統就不會在 Operations 清單中列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

動作

本節列出 LDAP 連接器支援的所有動作。

MoveToDN 動作

這項動作會將物件從一個 DN (辨別名稱) 移至另一個 DN。

MoveToDN 動作的輸入參數

DownloadFile 動作的輸出參數

這項動作會傳回狀態 200 (OK)，以及指出結果的回應內文。

如要瞭解如何設定 MoveToDN 動作，請參閱動作範例。

GetAttributes 動作

這項動作會取得 DN 的所有屬性名稱和值。

GetAttributes 動作的輸入參數

GetAttributes 動作的輸出參數

這項動作會傳回狀態 200 (OK)，以及指出結果的回應內文。

如要瞭解如何設定 GetAttributes 動作，請參閱動作範例。

AddMembersToGroup 動作

這項操作會將使用者加入群組。

GetAttributes 動作的輸入參數

AddMembersToGroup 動作的輸出參數

這項動作會傳回狀態 200 (OK)，以及指出結果的回應內文。

如要瞭解如何設定 AddMembersToGroup 動作，請參閱動作範例。

動作範例

本節說明如何在這個連接器中執行部分動作。

範例 - 將物件從一個 DN 移至另一個 DN

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 MoveToDN 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "DN": "CN=Google Cloud,OU=Bangalore,OU=India,OU=Domain_Users,DC=test-ldap,DC=com",
   "NewParentDN": "OU=Mysore,OU=India,OU=Domain_Users,DC=test-ldap,DC=com"
   }
     

這個範例會將物件從一個 DN 移至另一個 DN。如果動作成功，連接器工作 connectorOutputPayload 回應參數的值會類似以下內容：

[{
"Success": null,
"result": "[ok]",
"modified": "true",
"rss:title": "The movement was successful.",
"resultcode": "0"
}]

範例 - 取得 DN 的屬性

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 GetAttributes 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "DN": "CN=Bangalore user,OU=Bangalore,OU=India,OU=Domain_Users,DC=test-ldap,DC=com"
   }

這個範例會取得指定 DN 的屬性。如果動作成功，連接器工作 connectorOutputPayload 回應參數的值會類似以下內容：

[{
    "AttributeName": "_op",
    "AttributeValue": "ldapadoGetAttributes"
  }, {
    "AttributeName": "usncreated",
    "AttributeValue": "36006"
  }, {
    "AttributeName": "countrycode",
    "AttributeValue": "0"
  }, {
    "AttributeName": "badpwdcount",
    "AttributeValue": "0"
  }, {
    "AttributeName": "dn",
    "AttributeValue": ""
  }, {
    "AttributeName": "dn",
    "AttributeValue": "CN=Bangalore user,OU=Bangalore,OU=India,OU=Domain_Users,DC=test-ldap,DC=com"
  }, {
    "AttributeName": "whenchanged",
    "AttributeValue": "20230913125155.0Z"
  }, {
    "AttributeName": "objectclass",
    "AttributeValue": "top"
  }, {
    "AttributeName": "objectclass",
    "AttributeValue": "person"
  }, {
    "AttributeName": "objectclass",
    "AttributeValue": "organizationalPerson"
  }, {
    "AttributeName": "objectclass",
    "AttributeValue": "user"
  }, {
    "AttributeName": "primarygroupid",
    "AttributeValue": "513"
  }, {
    "AttributeName": "givenname",
    "AttributeValue": "Bangalore"
  }, {
    "AttributeName": "dscorepropagationdata",
    "AttributeValue": "16010101000001.0Z"
  }, {
    "AttributeName": "sn",
    "AttributeValue": "user"
  }, {
    "AttributeName": "useraccountcontrol",
    "AttributeValue": "512"
  }, {
    "AttributeName": "cn",
    "AttributeValue": "Bangalore user"
  }, {
    "AttributeName": "codepage",
    "AttributeValue": "0"
  }, {
    "AttributeName": "accountexpires",
    "AttributeValue": "9223372036854775807"
  }, {
    "AttributeName": "userprincipalname",
    "AttributeValue": "user-1@test-l
  }]  
  

範例 - 將使用者加入群組

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 AddMembersToGroup 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "GroupId": "1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com",
   "UserDNs": "[{\"DN\":\"CN=Google AI,CN=Users,DC=test-ldap,DC=com;CN=Guest,CN=Users,DC=test-ldap,DC=com\"}]"
   }

這個範例會將使用者 DN 新增至 ID 為 1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com 的群組。如果動作成功，連接器工作的回應參數 connectorOutputPayload 會包含類似下列的值：

[{
  "Success": "True"
  }]

實體作業範例

範例 - 列出使用者

這個範例會列出 User 實體中的所有使用者。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 User。
3. 選取「LIST」作業，然後按一下「完成」。
4. 您可以選擇篩選結果集。如要篩選結果集，請在「連線器」工作的「工作輸入」部分，根據需求設定 filterClause。

   舉例來說，如果將篩選器子句設為 Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com'，系統只會列出 ID 符合這項條件的記錄。

範例 - 取得使用者記錄

這個範例會從 User 實體取得使用者詳細資料。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 User。
3. 選取「GET」作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，按一下「EntityId」，然後在「預設值」欄位中輸入 1|CN=admin,CN=Users,DC=test-ldap,DC=com。

   其中 1|CN=admin,CN=Users,DC=test-ldap,DC=com 是 User 實體的主鍵值之一。

範例 - 建立使用者記錄

這個範例會在 User 實體中建立使用者記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 User。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "RDN": "CN=MPATAI",
   "ObjectClass": "top;person;organizationalPerson;user"
   }

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

    {
   "Id": "1|CN=MPATAI,CN=Users,DC=test-ldap,DC=com"
   }

範例 - 更新支援單

這個範例會更新 User 實體中指定的使用者記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 User。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
           "PostalCode": "560040"
         }
         

5. 按一下「entityId」，然後在「Default Value」欄位中輸入 1|CN=admin,CN=Users,DC=test-ldap,DC=com。

   或者，您也可以將 filterClause 設為 1|CN=admin,CN=Users,DC=test-ldap,DC=com，而非指定 entityId。

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   {
   "Id": "1|CN=admin,CN=Users,DC=test-ldap,DC=com"
   }
         

範例 - 刪除使用者記錄

這個範例會從 User 實體刪除使用者記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 User。
3. 選取「Delete」作業，然後按一下「完成」。
4. 在「連線器」工作的「Task Input」(工作輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 1|CN=admin,CN=Users,DC=test-ldap,DC=com。
5. 或者，如果 User 實體有複合式主鍵，您可以設定 filterClause，而不是指定 entityId。例如：Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com' and DN='CN=admin,CN=Users,DC=test-ldap,DC=com'。