Edge untuk Private Cloud v4.18.05
Ketika menggunakan SAML dengan Edge API, proses yang Anda gunakan untuk mendapatkan akses OAuth2 dan token refresh dari pernyataan SAML disebut alur kode sandi. Dengan alur kode sandi, Anda menggunakan browser untuk mendapatkan kode sandi sekali pakai yang kemudian digunakan untuk mendapatkan token OAuth2.
Namun, lingkungan pengembangan Anda mungkin mendukung otomatisasi untuk tugas pengembangan umum, seperti otomatisasi pengujian atau Continuous Integration/Continuous Deployment (CI/CD). Untuk mengotomatiskan tugas-tugas ini ketika SAML diaktifkan, Anda memerlukan cara untuk mendapatkan dan memperbarui token OAuth2 tanpa harus menyalin/menempel kode sandi dari browser.
Edge mendukung pembuatan token otomatis melalui penggunaan pengguna mesin. Pengguna mesin dapat memperoleh token OAuth2 tanpa harus menentukan kode sandi. Artinya, Anda dapat sepenuhnya mengotomatiskan proses mendapatkan dan memperbarui token OAuth2 dengan menggunakan Edge Management API.
Membuat pengguna perangkat
Gunakan utilitas apigee-ssoadminapi.sh
untuk membuat pengguna mesin untuk organisasi SAML. Lihat Menggunakan apigee-ssoadminapi.sh untuk mengetahui informasi selengkapnya. Anda dapat membuat satu pengguna mesin yang digunakan oleh semua organisasi, atau membuat pengguna mesin terpisah untuk setiap organisasi.
Pengguna mesin dibuat dan disimpan di datastore Edge, bukan di penyedia identitas SAML Anda. Oleh karena itu, Anda tidak bertanggung jawab untuk mempertahankan pengguna mesin dengan menggunakan Edge Ui dan Edge Management API.
Saat membuat pengguna mesin, Anda harus menentukan alamat email dan sandi. Setelah membuat pengguna mesin, Anda menetapkannya ke satu atau beberapa organisasi.
Untuk membuat pengguna mesin:
- Gunakan perintah
apigee-ssoadminapi.sh
berikut untuk membuat pengguna mesin:apigee-ssoadminapi.sh saml machineuser add --admin SSO_ADMIN_NAME \ --secret SSO_ADMIN_SECRET --host edge_sso_IP_or_DNS \ -u machine_user_email -p machine_user_password
Dengan keterangan:
- SSO_ADMIN_NAME adalah nama pengguna admin yang ditentukan oleh
properti
SSO_ADMIN_NAME
dalam file konfigurasi yang digunakan untuk mengonfigurasi modul SSO Edge. Default-nya adalahssoadmin
. - SSO_ADMIN_SECRET adalah sandi admin seperti yang ditentukan oleh properti
SSO_ADMIN_SECRET
dalam file konfigurasi.
Dalam contoh ini, Anda dapat menghilangkan nilai untuk
--port
dan--ssl
karena modulapigee-sso
menggunakan nilai default 9099 untuk--port
dan http untuk--ssl
. Jika penginstalan Anda tidak menggunakan default ini, tentukan sebagaimana mestinya. - SSO_ADMIN_NAME adalah nama pengguna admin yang ditentukan oleh
properti
- Login ke UI Edge dan tambahkan email pengguna mesin ke organisasi Anda, lalu tetapkan pengguna mesin ke peran yang diperlukan. Lihat Menambahkan pengguna global untuk informasi selengkapnya.
Mendapatkan dan memuat ulang token pengguna mesin
Gunakan Edge API untuk mendapatkan dan memperbarui token OAuth2 dengan meneruskan kredensial pengguna mesin, bukan kode sandi.
Untuk mendapatkan token OAuth2 bagi pengguna mesin:
- Gunakan panggilan API berikut untuk membuat akses awal dan token refresh:
curl -H "Content-Type: application/x-www-form-urlencoded;charset=utf-8" \ -H "accept: application/json;charset=utf-8" \ -H "Authorization: Basic ZWRnZWNsaTplZGdlY2xpc2VjcmV0" -X POST \ http://edge_sso_IP_DNS:9099/oauth/token -s \ -d 'grant_type=password&username=m_user_email&password=m_user_password'
Simpan token untuk digunakan nanti.
- Teruskan token akses ke panggilan API pengelolaan Edge sebagai header Bearer:
curl -H "Authorization: Bearer access_token" \ http://ms_IP_DNS:8080/v1/organizations/orgName
Dengan orgName adalah nama organisasi yang berisi pengguna perangkat.
- Untuk me-refresh token akses nanti, gunakan panggilan berikut yang menyertakan token refresh:
curl -H "Content-Type:application/x-www-form-urlencoded;charset=utf-8" \ -H "Accept: application/json;charset=utf-8" \ -H "Authorization: Basic ZWRnZWNsaTplZGdlY2xpc2VjcmV0" -X POST \ http://edge_sso_IP_DNS:9099/oauth/token \ -d 'grant_type=refresh_token&refresh_token=refreshToken'
Membuat pengguna mesin menggunakan Edge Management API
Anda dapat membuat pengguna mesin dengan menggunakan Edge management API, bukan menggunakan utilitas apigee-ssoadminapi.sh
.
Untuk membuat pengguna mesin:
- Gunakan perintah
curl
berikut untuk mendapatkan token bagi penggunassoadmin
, nama pengguna akun admin untukapigee-sso
:curl "http://edge_sso_IP_DNS:9099/oauth/token" -i -X POST \ -H 'Accept: application/json' / -H 'Content-Type: application/x-www-form-urlencoded' \ -d "response_type=token" -d "grant_type=client_credentials" \ --data-urlencode "client_secret=SSO_ADMIN_SECRET" \ --data-urlencode "client_id=ssoadmin"
Dengan SSO_ADMIN_SECRET adalah sandi admin yang Anda tetapkan saat menginstal
apigee-sso
seperti yang ditentukan oleh propertiSSO_ADMIN_SECRET
dalam file konfigurasi.Perintah ini menampilkan token yang Anda perlukan untuk melakukan panggilan berikutnya.
- Gunakan perintah
curl
berikut untuk membuat pengguna mesin, dengan meneruskan token yang Anda terima di langkah sebelumnya:curl "http://edge_sso_IP_DNS:9099/Users" -i -X POST \ -H "Accept: application/json" -H "Content-Type: application/json" \ -d '{"userName" : "machine_user_email", "name" : {"formatted":"DevOps", "familyName" : "last_name", "givenName" : "first_name"}, "emails" : [ {"value" : "machine_user_email", "primary" : true } ], "active" : true, "verified" : true, "password" : "machine_user_password" }' \ -H "Authorization: Bearer token"
Anda memerlukan sandi pengguna perangkat pada langkah berikutnya.
- Login ke UI Edge dan tambahkan email pengguna mesin ke organisasi Anda, lalu tetapkan pengguna mesin ke peran yang diperlukan. Lihat Menambahkan pengguna global untuk informasi selengkapnya.