application : addPasswordapplication: addPassword

Espace de noms: microsoft.graphNamespace: microsoft.graph

Ajoute un mot de passe fort à une application.Adds a strong password to an application.

AutorisationsPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Application. ReadWrite. All, Directory. AccessAsUser. AllApplication.ReadWrite.All, Directory.AccessAsUser.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Application.ReadWrite.OwnedBy, Application.ReadWrite.AllApplication.ReadWrite.OwnedBy, Application.ReadWrite.All

Requête HTTPHTTP request

POST /applications/{id}/addPassword

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obligatoire.application/json. Required.

Corps de la demandeRequest body

Dans le corps de la demande, fournissez un passwordCredential objet facultatif avec les propriétés suivantes.In the request body, provide an optional passwordCredential object with the following properties.

PropriétéProperty TypeType DescriptionDescription
displayNamedisplayName ChaîneString Nom convivial du mot de passe.Friendly name for the password. Facultatif.Optional.
endDateTimeendDateTime DateTimeOffsetDateTimeOffset Date et heure auxquelles le mot de passe expire, représentée au format ISO 8601 et qui est toujours en heure UTC.The date and time at which the password expires represented using ISO 8601 format and is always in UTC time. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Facultatif.Optional. La valeur par défaut est « startDateTime + 2 années ».The default value is "startDateTime + 2 years".
startDateTimestartDateTime DateTimeOffsetDateTimeOffset Date et heure auxquelles le mot de passe devient valide.The date and time at which the password becomes valid. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Facultatif.Optional. La valeur par défaut est « maintenant ».The default value is "now".

RéponseResponse

Si elle réussit, cette méthode renvoie un 200 OK Code de réponse et un nouvel objet passwordCredential dans le corps de la réponse.If successful, this method returns a 200 OK response code and a new passwordCredential object in the response body. La propriété secretText de l’objet Response contient les mots de passe forts générés par Azure Active Directory dont la longueur est de 16-64 caractères.The secretText property in the response object contains the strong passwords generated by Azure Active Directory that are 16-64 characters in length. Il n’existe aucun moyen de récupérer ce mot de passe à l’avenir.There is no way to retrieve this password in the future.

ExemplesExamples

L’exemple ci-après montre comment appeler cette API.The following example shows how to call this API.

DemandeRequest

Voici un exemple de demande.The following is an example of the request. L' ID spécifié dans la demande est la valeur de la propriété ID de l’application, et non la valeur de la propriété AppID .The id that is specified in the request is the value of the id property of the application, not the value of the appId property.

POST https://graph.microsoft.com/v1.0/applications/{id}/addPassword
Content-type: application/json

{
  "passwordCredential": {
    "displayName": "Password friendly name"
  }
}

RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

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

{
    "customKeyIdentifier": null,
    "endDateTime": "2021-09-09T19:50:29.3086381Z",
    "keyId": "f0b0b335-1d71-4883-8f98-567911bfdca6",
    "startDateTime": "2019-09-09T19:50:29.3086381Z",
    "secretText": "[6gyXA5S20@MN+WRXAJ]I-TO7g1:h2P8",
    "hint": "[6g",
    "displayName": "Password friendly name"
}