Démarrage rapide
Démarrez rapidement avec l'API REST des domaines d'identité en remplissant les conditions requises, en installant curl et en configurant l'autorisation de gérer vos ressources de domaine d'identité, telles que les utilisateurs, les groupes et les applications.
Préalables
- Acheter un abonnement à Oracle Cloud : Voir acheter un abonnement à Oracle Cloud.
- Activer votre commande : Configurez votre compte ou activez votre commande. Voir Activer votre commande à partir du courriel de bienvenue sous Acheter un abonnement Oracle Cloud.
- Obtenez les données d'identification de compte et l'autorisation appropriées pour accéder aux API du domaine d'identité auprès de votre administrateur de domaine d'identité :
-
Pour vous connecter à votre domaine d'identité. Consultez l'administrateur du domaine d'identité pour obtenir votre nom d'utilisateur, votre mot de passe et votre nom de domaine d'identité.
-
Pour utiliser l'API sans compte d'utilisateur. Les administrateurs peuvent utiliser l'API des domaines d'identité sans compte d'utilisateur dans le domaine d'identité. Pour utiliser l'API des domaines d'identité sans compte d'utilisateur, demandez un ID client et une clé secrète client à l'administrateur du domaine d'identité.
-
Étape 1 : Connectez-vous à votre domaine d'identité
Après avoir activé votre compte, vous recevez des données d'identification de connexion et un lien vers la page d'accueil de votre domaine d'identité. Sélectionnez le lien dans le courriel, puis entrez les données d'identification de connexion fournies. La page d'accueil de votre domaine d'identité s'affiche. Voir Connexion à la console.
Étape 2 : Installer cURL
Les exemples dans ce document utilisent l'outil de ligne de commande cURL pour démontrer comment accéder à l'API REST des domaines d'identité.
Pour vous connecter en toute sécurité au serveur, vous devez installer une version de cURL qui prend en charge SSL et fournir un fichier ou un ensemble de certificats d'autorité de certification SSL pour vous authentifier auprès du certificat de l'autorité de certification Verisign. Pour plus d'informations sur :
-
À l'aide de cURL, voir Utilisation de cURL.
-
Autorisation, voir Gestion de l'autorisation à l'aide de l'API.
-
Dans un navigateur, naviguez jusqu'à la page d'accueil cURL à l'adresse http://curl.haxx.se/download.html.
-
Dans la page Versions et téléchargements cURL, recherchez la version compatible SSL qui correspond à votre système d'exploitation, puis sélectionnez le lien pour télécharger le fichier ZIP.
-
Installer le logiciel.
-
Naviguez jusqu'à la page cURL CA Certs à l'adresse http://curl.haxx.se/docs/caextract.html, puis téléchargez l'ensemble de certificats d'autorité de certification SSL CA-bundle.crt dans le dossier où vous avez installé cURL.
-
Définissez la variable d'environnement cURL :
-
Ouvrez une fenêtre de commande.
-
Accédez au répertoire dans lequel vous avez installé cURL.
-
Réglez la variable d'environnement cURL (CURL_CA_BUNDLE) à l'emplacement de l'ensemble de certificats SSLCA. Par exemple :
C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt.
-
Étape 3 : Comprendre le format d'URL de ressource
Vous accédez à l'API REST des domaines d'identité à l'aide d'une URL, qui inclut le point d'extrémité REST, la ressource à laquelle vous voulez accéder et tous les paramètres d'interrogation que vous voulez inclure dans une demande.
Le point d'extrémité de base de l'API REST des domaines d'identité est :
https://<domainURL>/admin/v1/Voir Envoyer des demandes pour plus de détails sur la création de ces URL.
Étape 4 : Configurer l'autorisation
Vous devez générer le jeton d'accès que vous pouvez ensuite utiliser pour autoriser les demandes que vous envoyez à l'API REST des domaines d'identité. Voir Gestion de l'autorisation à l'aide de l'API.
Vous êtes maintenant prêt à envoyer des demandes à un domaine d'identité à l'aide de cURL.
Étape 5 : Gérer les ressources de votre domaine d'identité
Commencez à utiliser l'API REST pour gérer les configurations, les identités et les ressources globales du domaine d'identité.