Tipo de recurso objectIdentity

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

Representa uma identidade usada para entrar em uma conta de usuário. Uma identidade pode ser fornecida pela Microsoft, por organizações ou por provedores de identidade social, como Facebook, Google ou Microsoft, que estão vinculados a uma conta de usuário. Isso permite que o usuário entre na conta de usuário com qualquer uma dessas identidades associadas.

A propriedade de identidades do recurso de usuário é um objeto objectIdentity .

Propriedades

Propriedade	Tipo	Descrição
signInType	Cadeia de caracteres	Especifica os tipos de entrada do usuário em seu diretório, como emailAddress, userName, federatedou userPrincipalName. federated representa um identificador exclusivo para um usuário de um emissor, que pode estar em qualquer formato escolhido pelo emissor. A configuração ou a atualização userPrincipalName de uma identidade atualizará o valor da propriedade userPrincipalName no objeto de usuário. As validações executadas userPrincipalName na propriedade no objeto de usuário, por exemplo, domínios verificados e caracteres aceitáveis, serão executadas ao definir ou atualizar uma userPrincipalName identidade. A validação adicional é imposta em issuerAssignedId quando o tipo de entrada é definido como emailAddress ou userName. Essa propriedade também pode ser definida como qualquer cadeia de caracteres personalizada.
Emissor	string	Especifica o emissor da identidade, por exemplo facebook.com. Para contas locais (onde signInType não está federated), essa propriedade é o nome de domínio padrão do locatário B2C local, por exemplo contoso.onmicrosoft.com. Para usuários externos de Azure AD organização, esse será o domínio da organização federada, por exemplocontoso.com. Suporta o $filter. Limite de 512 caracteres.
issuerAssignedId	string	Especifica o identificador exclusivo atribuído ao usuário pelo emissor. A combinação de issuer e issuerAssignedId deve ser exclusiva dentro da organização. Representa o nome de entrada do usuário, quando signInType é definido como emailAddress ou userName (também conhecido como contas locais). Quando signInType é definido como: emailAddress, (ou uma cadeia de caracteres personalizada que começa com emailAddress like emailAddress1), issuerAssignedId deve ser um endereço de email válido userName, issuerAssignedId deve ser uma parte local válida de um endereço de email Suporta o $filter. Limite de 100 caracteres.

Filtragem

Ao filtrar a propriedade de identidades para um issuerAssignedId, você deve fornecer o emissor e o issuerAssignedId. Além disso:

• A filtragem de entradas com um signInType de federated requer um emissor válido e issuerAssignedId.
• A filtragem de entradas com um signInType de userName ou emailAddress ignora o valor do emissor. Este é o comportamento padrão do produto.
• Não há suporte para a filtragem de entradas com um signInTypeuserPrincipalName. Em vez disso, isso pode ser feito filtrando a propriedade userPrincipalName no objeto de usuário.

Somente a filtragem no emissor tem suporte para os seguintes valores: google.com, facebook.com, maile phone.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "signInType": "string",
  "issuer": "string",
  "issuerAssignedId": "string"
}