servicePrincipal : createPasswordSingleSignOnCredentials

Espace de noms: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur de version .

Créez des informations d’identification d’sign-on unique à l’aide d’un mot de passe pour un utilisateur ou un groupe.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Application.ReadWrite.All et Directory.Read.All, Directory.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Application.ReadWrite.All et Directory.Read.All, Directory.ReadWrite.All

Notes

Les utilisateurs peuvent créer des informations d’identification pour eux-mêmes. Les propriétaires et administrateurs principaux de service ayant les rôles suivants peuvent créer des informations d’identification pour n’importe quel utilisateur ou groupe : GlobalAdministrator, ApplicationAdministrator, CloudApplicationAdministrator. Pour plus d’informations, voir Rôles d’annuaire.

Requête HTTP

POST /servicePrincipals/{id}/createPasswordSingleSignOnCredentials

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.

Paramètre Type Description
id Chaîne ID de l’utilisateur ou du groupe à qui appartient cet ensemble d’informations d’identification.
credentials collection d’informations d’identification Liste des objets d’informations d’identification qui définissent le flux de connexion complet.

Réponse

Si elle réussit, cette méthode 200 OK renvoie un code de réponse et un nouvel objet passwordSingleSignOnCredentialSet dans le corps de la réponse.

Exemples

Demande

Voici un exemple de requête.

POST https://graph.microsoft.com/beta/servicePrincipals/{id}/createPasswordSingleSignOnCredentials
Content-type: application/json

{
  "id": "5793aa3b-cca9-4794-679a240f8b58",
  "credentials": [
    {
      "fieldId": "param_username",
      "value": "myusername",
      "type": "username"
    },
    {
      "fieldId": "param_password",
      "value": "pa$$w0rd",
      "type": "password"
    }
  ]
}

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "5793aa3b-cca9-4794-679a240f8b58",
  "credentials": [
    {
      "fieldId": "param_username",
      "value": "myusername",
      "type": "username"
    },
    {
      "fieldId": "param_password",
      "value": null,
      "type": "password"
    }
  ]
}