servicePrincipal: createPasswordSingleSignOnCredentialsservicePrincipal: createPasswordSingleSignOnCredentials

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

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