objectIdentity tipo de recurso

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 exemplocontoso.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:
  • 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 começar com um caractere alfabético ou número e só pode conter caracteres alfanuméricos e os seguintes símbolos: - ou _


  • 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, e phone.
  • A filtragem de entradas com um signInType requer federated um emissor válido e um issuerAssignedId.
  • A filtragem de entradas com um signInType de userName ou emailAddress requer 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 userPrincipalName entradas 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"
}