LDAP

Entitas, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

• Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, di konektor database, tabel adalah entitas, di konektor server file, folder adalah entitas, dan di konektor sistem pesan, antrean adalah entitas.

  Namun, ada kemungkinan konektor tidak mendukung atau tidak memiliki entity apa pun, sehingga daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Daftar
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan berbeda-beda dari konektor ke konektor. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, sehingga daftar Actions akan kosong.

Tindakan

Bagian ini mencantumkan semua tindakan yang didukung oleh konektor LDAP.

Tindakan MoveToDN

Tindakan ini memindahkan objek dari satu DN (nama yang dibedakan) ke DN lainnya.

Parameter input tindakan MoveToDN

Parameter output tindakan DownloadFile

Tindakan ini menampilkan status 200 (OK) dengan isi respons yang menunjukkan hasilnya.

Untuk memahami cara mengonfigurasi tindakan MoveToDN, lihat Contoh tindakan.

Tindakan GetAttributes

Tindakan ini akan mendapatkan semua nama dan nilai atribut DN.

Parameter input tindakan GetAttributes

Parameter output tindakan GetAttributes

Tindakan ini menampilkan status 200 (OK) dengan isi respons yang menunjukkan hasilnya.

Untuk memahami cara mengonfigurasi tindakan GetAttributes, lihat Contoh tindakan.

Tindakan AddMembersToGroup

Tindakan ini menambahkan pengguna ke grup.

Parameter input tindakan GetAttributes

Parameter output tindakan AddMembersToGroup

Tindakan ini menampilkan status 200 (OK) dengan isi respons yang menunjukkan hasilnya.

Untuk memahami cara mengonfigurasi tindakan AddMembersToGroup, lihat Contoh tindakan.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan di konektor ini.

Contoh - Memindahkan objek dari satu DN ke DN lain

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan MoveToDN, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom 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"
   }
     

Contoh ini memindahkan objek dari satu DN ke DN lainnya. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - Mendapatkan atribut DN

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan GetAttributes, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

Contoh ini mendapatkan atribut DN yang ditentukan. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

[{
    "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
  }]  
  

Contoh - Menambahkan pengguna ke grup

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan AddMembersToGroup, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom 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\"}]"
   }

Contoh ini menambahkan DN pengguna ke grup dengan ID 1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

[{
  "Success": "True"
  }]

Contoh operasi entity

Contoh - Mencantumkan pengguna

Contoh ini mencantumkan semua pengguna di entitas User.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih User dari daftar Entity.
3. Pilih operasi LIST, lalu klik Selesai.
4. Secara opsional, Anda dapat memfilter set hasil. Untuk memfilter set hasil, di bagian Input Tugas pada tugas Konektor, tetapkan filterClause sesuai kebutuhan Anda.

   Misalnya, menyetel klausa filter ke Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com', hanya mencantumkan data yang ID-nya cocok dengan kriteria ini.

Contoh - Mendapatkan catatan pengguna

Contoh ini mendapatkan detail pengguna dari entity User.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih User dari daftar Entity.
3. Pilih operasi GET, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik EntityId, lalu masukkan 1|CN=admin,CN=Users,DC=test-ldap,DC=com di kolom Default Value.

   Di sini, 1|CN=admin,CN=Users,DC=test-ldap,DC=com adalah salah satu nilai kunci utama entity User.

Contoh - Membuat rekaman pengguna

Contoh ini membuat catatan pengguna dalam entitas User.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih User dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - Memperbarui tiket

Contoh ini memperbarui catatan pengguna yang ditentukan dalam entity User.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih User dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
           "PostalCode": "560040"
         }
         

5. Klik entityId, lalu masukkan 1|CN=admin,CN=Users,DC=test-ldap,DC=com di kolom Default Value.

   Atau, alih-alih menentukan entityId, Anda juga dapat menyetel filterClause ke 1|CN=admin,CN=Users,DC=test-ldap,DC=com.

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - Menghapus data pengguna

Contoh ini menghapus data pengguna dari entitas User.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih User dari daftar Entity.
3. Pilih operasi Delete, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan 1|CN=admin,CN=Users,DC=test-ldap,DC=com di kolom Default Value.
5. Atau, jika entitas User memiliki kunci utama gabungan, alih-alih menentukan entityId, Anda dapat menyetel filterClause. Misalnya, Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com' and DN='CN=admin,CN=Users,DC=test-ldap,DC=com'.