Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 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. Isso permite que o usuário entre na conta do usuário com qualquer uma dessas identidades associadas.
A propriedade identities 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 no seu diretório, como emailAddress, userName, federated, ou userPrincipalName.
federated Representa um identificador exclusivo para um usuário de um emissor que pode estar em qualquer formato escolhido pelo emissor. Configurar ou atualizar uma userPrincipalName identidade atualiza o valor da propriedade userPrincipalName no objeto de usuário. As validações executadas na userPrincipalName propriedade no objeto de usuário, por exemplo, domínios verificados e caracteres aceitáveis, são executadas ao configurar ou atualizar uma userPrincipalName identidade. A validação extra é 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. Para obter mais informações sobre o comportamento de filtragem dessa propriedade, consulte Filtragem na propriedade de identidades de um usuário. |
| do emissor | Cadeia de caracteres | Especifica o emissor da identidade, por exemplo facebook.com. Limite de 512 caracteres. Para contas locais (em que signInType não federatedé), essa propriedade é o nome de domínio padrão local para o locatário, por exemplo contoso.com. Para convidados de outras organizações do Microsoft Entra, esse é o domínio da organização federada, por exemplo contoso.com. Para obter mais informações sobre o comportamento de filtragem dessa propriedade, consulte Filtragem na propriedade de identidades de um usuário. |
| issuerAssignedId | Cadeia de caracteres | Especifica o identificador exclusivo atribuído ao usuário pelo emissor. Limite de 64 caracteres. 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 está definido como:
Para obter mais informações sobre o comportamento de filtragem dessa propriedade, consulte Filtragem na propriedade de identidades de um usuário. |
Filtragem
Ao filtrar a propriedade de identidades de um issuerAssignedId:
- A filtragem apenas do emissor tem suporte para os seguintes valores:
google.com,facebook.com,mail, ephone. - A filtragem de entradas com um signInType requer
federatedum emissor válido e um issuerAssignedId. - A filtragem de entradas com um signInType de
userNameouemailAddressrequer um emissor válido e issuerAssignedId , mas ignora o valor do emissor. Este é o comportamento padrão do produto. - Não há suporte para a filtragem de
userPrincipalNameentradas com um signInType. Em vez disso, você pode filtrar a propriedade userPrincipalName no objeto de usuário.
Relações
Nenhum
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"signInType": "string",
"issuer": "string",
"issuerAssignedId": "string"
}