vRealize Operations Manager requiert l'authentification des demandes d'API. La première étape de ce workflow consiste à obtenir un jeton d'authentification.
Note : Cet exemple utilise l'authentification basée sur un jeton. Pour plus d'informations sur les mécanismes d'authentification, reportez-vous à la section
Sécurité.
Conditions préalables
- Sécurisez un canal entre le navigateur Web et le serveur vRealize Operations Manager. Ouvrez un navigateur et entrez l'URL d'une instance de vRealize Operations Manager telle que :
https://vrealize.example.com
Le système vous avertit que votre connexion n'est pas privée. Cliquez pour confirmer l'exception de sécurité et établir une liaison SSL.
- Vérifiez que vous pouvez accéder aux API. Entrez l'URL de votre instance de vRealize Operations Manager en ajoutant suite-api/docs/rest/index.html à la fin, par exemple :
https://vrealize.example.com/suite-api/docs/rest/index.html
- Vérifiez que vous disposez des informations d'identification de connexion d'un utilisateur de votre instance de vRealize Operations Manager.
Procédure
Exemple : Demande de connexion et réponse
Cet exemple présente une demande et une réponse pour un utilisateur dont le nom d'utilisateur de connexion est : vRealize-user et le mot de passe est : vRealize-dummy-password.
En-tête de la demande :
POST https://vrealize.example.com/suite-api/api/auth/token/acquire Content-Type: application/json Accept: application/json
Corps de la demande au format JSON :
{ "username" : "vRealize-user", "password" : "vRealize-dummy-password" }
Réponse au format JSON :
200 OK
{ "token": "8f868cca-27cc-43d6-a838-c5467e73ec45::77cea9b2-1e87-490e-b626-e878beeaa23b", "validity": 1470421325035, "expiresAt": "Friday, August 5, 2016 6:22:05 PM UTC", "roles": [] }
Le code de réponse indique si la demande a réussi ou pourquoi elle a échoué.
- Si la demande a réussi, le serveur renvoie le code de réponse HTTP 200 (OK) et un jeton d'autorisation ops réutilisable, qui expire après six heures. Ce jeton doit être inclus dans toutes les demandes d'API suivantes.
- Si l'en-tête d'autorisation manque pour cette demande, le serveur renvoie le code de réponse HTTP 403.
- Si les informations d'identification fournies dans l'en-tête d'autorisation ne sont pas valides, le serveur renvoie le code de réponse HTTP 401.