Mulai cepat: Mulai menggunakan provisi masuk berbasis API menggunakan cURL

2025-05-01

Perkenalan

cURL adalah alat baris perintah populer, gratis, sumber terbuka, yang digunakan oleh pengembang API, dan tersedia secara default pada Windows 10/11. Tutorial ini menjelaskan bagaimana Anda dapat dengan cepat menguji penyediaan masuk berbasis API dengan cURL.

Prasyarat

Anda mengonfigurasi aplikasi provisi masuk berbasis API.
Anda mengonfigurasi perwakilan layanan dan memiliki akses ke API provisi masuk. Catat ClientId dan ClientSecret aplikasi perwakilan layanan Anda untuk digunakan dalam tutorial ini.

Mengunggah data pengguna ke API provisi masuk

Ambil client_id dan client_secret dari service principal yang memiliki akses ke API provisi masuk.

Gunakan alur pemberian client_credentials OAuth untuk mendapatkan token akses. Ganti variabel [yourClientId], [yourClientSecret] dan [yourTenantId] dengan nilai yang berlaku untuk penyiapan Anda dan jalankan perintah cURL berikut. Salin nilai token akses yang dihasilkan

curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=[yourClientId]&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default&client_secret=[yourClientSecret]&grant_type=client_credentials" "https://login.microsoftonline.com/[yourTenantId]/oauth2/v2.0/token"

Salin permintaan massal dengan Skema Pengguna Perusahaan SCIM dan simpan konten dalam file yang disebut scim-bulk-upload-users.json.
Ganti variabel [InboundProvisioningAPIEndpoint] dengan titik akhir API provisi yang terkait dengan aplikasi provisi Anda. Gunakan nilai [AccessToken] dari langkah sebelumnya dan jalankan perintah curl berikut untuk mengunggah permintaan massal ke titik akhir API provisi.
```
curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
```
Setelah berhasil diunggah, Anda menerima kode respons HTTP 202 Diterima.
Layanan provisi mulai memproses payload permintaan massal segera dan Anda dapat melihat detail provisi dengan mengakses log provisi aplikasi provisi masuk.

Verifikasi pemrosesan muatan permintaan massal

Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi.
Telusuri ke Entra ID>Aplikasi Perusahaan.
Di bawah semua aplikasi, gunakan kotak teks filter pencarian untuk menemukan dan membuka aplikasi provisi berbasis API Anda.
Buka bilah Provisi. Halaman muka menampilkan status pelaksanaan terakhir.
Pilih Tampilkan log provisi untuk membuka bilah log provisi. Atau, Anda dapat memilih opsi menu Monitor>Log Provisioning.
Pilih rekaman apa pun di log provisi untuk melihat detail pemrosesan lainnya.
Layar detail log provisi menampilkan semua langkah yang dijalankan untuk pengguna tertentu.
- Di bawah langkah Impor dari API, lihat detail data pengguna yang diekstrak dari permintaan massal.
- Langkah Cocokkan pengguna menunjukkan detail kecocokan pengguna berdasarkan pengidentifikasi yang cocok. Jika kecocokan pengguna terjadi, maka layanan provisi melakukan operasi pembaruan. Jika tidak ada kecocokan pengguna, maka layanan penyediaan melakukan operasi pembuatan.
- Langkah Menentukan apakah Pengguna berada dalam cakupan memperlihatkan detail evaluasi filter cakupan. Secara default, semua pengguna diproses. Jika Anda mengatur filter cakupan (misalnya, hanya memproses pengguna milik departemen Penjualan), detail evaluasi filter cakupan ditampilkan dalam langkah ini.
- Langkah Penyediaan Pengguna menyebutkan langkah pemrosesan akhir serta perubahan yang diterapkan ke akun pengguna.
- Gunakan tab properti Diubah untuk melihat pembaruan atribut.

Lampiran

Lihat bagian ini untuk informasi tentang permintaan massal dengan Skema Pengguna Perusahaan SCIM.

Permintaan massal dengan Skema Pengguna SCIM Enterprise

Permintaan massal yang ditampilkan sebagai berikut menggunakan Skema Pengguna Inti dan Pengguna Perusahaan standar SCIM.

Isi Permintaan

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701984",
            "userName": "bjensen@example.com",
            "name": {
                "formatted": "Ms. Barbara J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Barbara",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Babs Jensen",
            "nickName": "Babs",
            "emails": [
            {
              "value": "bjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Universal City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91608",
              "country": "USA",
              "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5555",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Guide",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701984",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "89607",
                     "displayName": "John Smith"
                 }
            }
        }
    },
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701985",
            "userName": "Kjensen@example.com",
            "name": {
                "formatted": "Ms. Kathy J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Kathy",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Kathy Jensen",
            "nickName": "Kathy",
            "emails": [
            {
              "value": "kjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Oracle City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91618",
              "country": "USA",
              "formatted": "100 Oracle City Plaza\nHollywood, CA 91618 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5545",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Lead",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701985",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "701984",
                     "displayName": "Barbara Jensen"
                 }
            }
        }
    }
],
    "failOnErrors": null
}

Bagikan melalui