Compartilhar via


tipo de recurso socialIdentityProvider

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 fornecedores de identidade social com Identidades Externas para inquilinos Microsoft Entra ID e Azure AD B2C.

Herdado de identityProviderBase.

Para Microsoft Entra cenários B2B num inquilino Microsoft Entra, o tipo de fornecedor de identidade pode ser Google ou Facebook.

Configurar um fornecedor de identidade no inquilino do Microsoft Entra permite novos cenários de convidado Microsoft Entra B2B. Por exemplo, uma organização possui recursos no Microsoft 365 que precisam ser compartilhados com um usuário do Gmail. O usuário do Gmail usará as credenciais de conta do Google para autenticar e acessar os documentos.

Em um locatário do Azure AD B2C, o tipo de provedor de identidade pode ser Microsoft, Google, Facebook, Amazon, LinkedIn ou Twitter. Os seguintes provedores de identidade estão em visualização: Weibo, QQ, WeChat e GitHub.

Configurar um provedor de identidade em seu locatário do Azure AD B2C permite que os usuários se inscrevam e entrem usando um provedor com suporte de conta social em um aplicativo. Por exemplo, um aplicativo pode usar o Azure AD B2C para permitir que os usuários se inscrevam no serviço usando uma conta do Facebook.

Métodos

Método Tipo de retorno Descrição
Listar fornecedores de identidade configurados Coleção identityProviderBase Recupere todos os provedores de identidade configurados em um locatário, incluindo os tipos de objeto socialIdentityProvider. Não há como recuperar apenas os provedores de identidade social em um locatário.
Criar o provedor de identidade socialidentityprovider Crie um novo objeto socialIdentityProvider .
Obter o provedor de identidade socialidentityprovider Recupere propriedades de um objeto socialIdentityProvider.
Atualizar fornecedor de identidade Nenhum(a) Atualize um objeto socialIdentityProvider.
Excluir provedor de identidade Nenhum Exclua um objeto socialIdentityProvider.
Listar fornecedores de identidade disponíveis Coleção de cadeias de caracteres Recuperar todos os tipos de provedores de identidade disponíveis no locatário.

Propriedades

Propriedade Tipo Descrição
clientId Cadeia de caracteres O identificador do cliente para o aplicativo obtido ao registrar o aplicativo com o provedor de identidade. Obrigatório.
clientSecret Cadeia de caracteres O segredo do cliente para o aplicativo obtido quando o aplicativo é registrado com o provedor de identidade. Isso é somente gravação. Uma operação de leitura retorna ****. Obrigatório.
id Cadeia de caracteres O identificador do provedor de identidade. Herdado de identityProviderBase. Somente leitura.
displayName Cadeia de caracteres O nome de exibição exclusivo do provedor de identidade. Herdado de identityProviderBase.
identityProviderType Cadeia de caracteres Para um cenário B2B, valores possíveis: Google, Facebook. Para um cenário B2C, valores possíveis: Microsoft, Google, Amazon, LinkedIn, Facebook, GitHub, Twitter, Weibo, QQ, WeChat. Obrigatório.

Onde obter o identificador e o segredo do cliente

Cada provedor de identidade tem um processo para criar um registro do aplicativo. Por exemplo, os usuários criam um registro de aplicativo com o Facebook no developers.facebook.com. O identificador do cliente e o segredo do cliente resultantes podem ser passados para criar identityProvider. Em seguida, cada objeto de usuário no diretório pode ser federado para qualquer um dos provedores de identidade do locatário para autenticação. Isso permite que o usuário entre inserindo credenciais na página de entrada do provedor de identidade. O token do fornecedor de identidade é validado por Microsoft Entra ID antes de o inquilino emitir um token para a aplicação.

Representação JSON

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

{
    "id": "String",
    "identityProviderType": "String",
    "displayName": "String",
    "clientId": "String",
    "clientSecret": "String"
}