servicePrincipal: createPasswordSingleSignOnCredentialsservicePrincipal: createPasswordSingleSignOnCredentials

06/02/2021
3 minutos para o fim da leitura

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs sob /beta a versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível na versão 1.0, use o seletor de versão.To determine whether an API is available in v1.0, use the Version selector.

Crie credenciais de login único usando uma senha para um usuário ou grupo.Create single sign-on credentials using a password for a user or group.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type	Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account)	Application.ReadWrite.All e Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllApplication.ReadWrite.All and Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account)	Sem suporte.Not supported.
ApplicationApplication	Application.ReadWrite.All e Directory.Read.All, Directory.ReadWrite.AllApplication.ReadWrite.All and Directory.Read.All, Directory.ReadWrite.All

Observação

Os usuários podem criar credenciais para si próprios.Users can create credentials for themselves. Os proprietários e administradores da entidade de serviço com as seguintes funções podem criar credenciais para qualquer usuário ou grupo: GlobalAdministrator, ApplicationAdministrator, CloudApplicationAdministrator.Service principal owners and admins with the following roles can create credentials for any user or group: GlobalAdministrator, ApplicationAdministrator, CloudApplicationAdministrator. Para saber mais, consulte Funções de diretório.To learn more, see Directory roles.

Solicitação HTTPHTTP request

POST /servicePrincipals/{id}/createPasswordSingleSignOnCredentials

Cabeçalhos de solicitaçãoRequest headers

NomeName	DescriçãoDescription
AutorizaçãoAuthorization	{token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type	application/json. Obrigatório.application/json. Required.

Corpo da solicitaçãoRequest body

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.In the request body, provide a JSON object with the following parameters.

ParâmetroParameter	TipoType	DescriçãoDescription
idid	StringString	A ID do usuário ou grupo ao que esse conjunto de credenciais pertence.The ID of the user or group this credential set belongs to.
credenciaiscredentials	coleção de credenciaiscredential collection	Uma lista de objetos de credencial que definem o fluxo de login completo.A list of credential objects that define the complete sign in flow.

RespostaResponse

Se tiver êxito, este método retornará um código de resposta e um novo objeto 200 OK passwordSingleSignOnCredentialSet no corpo da resposta.If successful, this method returns a 200 OK response code and a new passwordSingleSignOnCredentialSet object in the response body.

ExemplosExamples

SolicitaçãoRequest

Veja a seguir um exemplo de uma solicitação.The following is an example of a request.

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();

Importante

Os SDKs do Microsoft Graph usam a versão v 1.0 da API por padrão e não dão suporte a todos os tipos, propriedades e APIs disponíveis na versão beta.Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. Para obter detalhes sobre como acessar a API beta com o SDK, consulte usar os SDKs do Microsoft Graph com a API beta.For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

Leia a documentação do SDK para obter detalhes sobre como Adicionar o SDK ao seu projeto e criar uma instância de authprovider .Read the SDK documentation for details about how to add the SDK to your project and create an authProvider instance.


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);

Importante


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];

Importante


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();

Importante

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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: createPasswordSingleSignOnCredentialsservicePrincipal: createPasswordSingleSignOnCredentials

PermissõesPermissions

Solicitação HTTPHTTP request

Cabeçalhos de solicitaçãoRequest headers

Corpo da solicitaçãoRequest body

RespostaResponse

ExemplosExamples

SolicitaçãoRequest

RespostaResponse

Esta página é útil?

Esta página é útil?