servicePrincipal : createPasswordSingleSignOnCredentials

Article
04/06/2022
5 minutes de lecture

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"
    }
  ]
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var id = "5793aa3b-cca9-4794-679a240f8b58";

var credentials = new List<Credential>()
{
    new Credential
    {
        FieldId = "param_username",
        Value = "myusername",
        Type = "username"
    },
    new Credential
    {
        FieldId = "param_password",
        Value = "pa$$w0rd",
        Type = "password"
    }
};

await graphClient.ServicePrincipals["{servicePrincipal-id}"]
    .CreatePasswordSingleSignOnCredentials(id,credentials)
    .Request()
    .PostAsync();

Important

Les Kits de développement logiciel (SDK) Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Lisez la documentation du Kit de développement logiciel ( SDK ) pour plus d’informations sur l’ajout du kit SDK à votre projet et la création d’une instance authProvider .


const options = {
    authProvider,
};

const client = Client.init(options);

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

await client.api('/servicePrincipals/{id}/createPasswordSingleSignOnCredentials')
    .version('beta')
    .post(passwordSingleSignOnCredentialSet);

Important

Lisez la documentation du Kit de développement logiciel ( SDK ) pour plus d’informations sur l’ajout du kit SDK à votre projet et la création d’une instance authProvider .


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/servicePrincipals/{id}/createPasswordSingleSignOnCredentials"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

NSMutableDictionary *payloadDictionary = [[NSMutableDictionary alloc] init];

NSString *id = @"5793aa3b-cca9-4794-679a240f8b58";
payloadDictionary[@"id"] = id;

NSMutableArray *credentialsList = [[NSMutableArray alloc] init];
MSGraphCredential *credentials = [[MSGraphCredential alloc] init];
[credentials setFieldId:@"param_username"];
[credentials setValue:@"myusername"];
[credentials setType:@"username"];
[credentialsList addObject: credentials];
MSGraphCredential *credentials = [[MSGraphCredential alloc] init];
[credentials setFieldId:@"param_password"];
[credentials setValue:@"pa$$w0rd"];
[credentials setType:@"password"];
[credentialsList addObject: credentials];
payloadDictionary[@"credentials"] = credentialsList;

NSData *data = [NSJSONSerialization dataWithJSONObject:payloadDictionary options:kNilOptions error:&error];
[urlRequest setHTTPBody:data];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Important

Lisez la documentation du Kit de développement logiciel ( SDK ) pour plus d’informations sur l’ajout du kit SDK à votre projet et la création d’une instance authProvider .


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

String id = "5793aa3b-cca9-4794-679a240f8b58";

LinkedList<Credential> credentialsList = new LinkedList<Credential>();
Credential credentials = new Credential();
credentials.fieldId = "param_username";
credentials.value = "myusername";
credentials.type = "username";

credentialsList.add(credentials);
Credential credentials1 = new Credential();
credentials1.fieldId = "param_password";
credentials1.value = "pa$$w0rd";
credentials1.type = "password";

credentialsList.add(credentials1);

graphClient.servicePrincipals("{id}")
    .createPasswordSingleSignOnCredentials(ServicePrincipalCreatePasswordSingleSignOnCredentialsParameterSet
        .newBuilder()
        .withId(id)
        .withCredentials(credentialsList)
        .build())
    .buildRequest()
    .post();

Important

Lisez la documentation du Kit de développement logiciel ( SDK ) pour plus d’informations sur l’ajout du kit SDK à votre projet et la création d’une instance authProvider .


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.New()
id := "5793aa3b-cca9-4794-679a240f8b58"
requestBody.SetId(&id)
requestBody.SetCredentials( []Credential {
    msgraphsdk.NewCredential(),
    SetAdditionalData(map[string]interface{}{
        "fieldId": "param_username",
        "value": "myusername",
        "type": "username",
    }
    msgraphsdk.NewCredential(),
    SetAdditionalData(map[string]interface{}{
        "fieldId": "param_password",
        "value": "pa$$w0rd",
        "type": "password",
    }
}
servicePrincipalId := "servicePrincipal-id"
result, err := graphClient.ServicePrincipalsById(&servicePrincipalId).CreatePasswordSingleSignOnCredentials(servicePrincipal-id).Post(requestBody)

Important

Lisez la documentation du Kit de développement logiciel ( SDK ) pour plus d’informations sur l’ajout du kit SDK à votre projet et la création d’une instance authProvider .


Import-Module Microsoft.Graph.Applications

$params = @{
    Id = "5793aa3b-cca9-4794-679a240f8b58"
    Credentials = @(
        @{
            FieldId = "param_username"
            Value = "myusername"
            Type = "username"
        }
        @{
            FieldId = "param_password"
            Value = "pa$$w0rd"
            Type = "password"
        }
    )
}

New-MgServicePrincipalPasswordSingleSignOnCredentials -ServicePrincipalId $servicePrincipalId -BodyParameter $params

Important

Lisez la documentation du Kit de développement logiciel ( SDK ) pour plus d’informations sur l’ajout du kit SDK à votre projet et la création d’une instance authProvider .

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"
    }
  ]
}

servicePrincipal : createPasswordSingleSignOnCredentials

Cette page est-elle utile ?

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemples

Demande

Réponse

Commentaires