Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Namespace: microsoft.graph
Obtenha uma coleção de recursos de provedor de identidade configurados para um locatário e que são derivados de identityProviderBase.
Para um locatário do Microsoft Entra, os provedores podem ser objetos socialIdentityProviders ou builtinIdentityProviders.
Para um Azure AD B2C, os provedores podem ser objetos socialIdentityProvider ou appleManagedIdentityProvider.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | IdentityProvider.Read.All | IdentityProvider.ReadWrite.All |
| Delegada (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | IdentityProvider.Read.All | IdentityProvider.ReadWrite.All |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. O Administrador de Provedor de Identidade Externo é a função com menos privilégios com suporte para esta operação.
Solicitação HTTP
GET /identity/identityProviders
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK código de resposta e uma coleção de objetos socialIdentityProvider ou builtinIdentityProvider no corpo da resposta para um locatário do Microsoft Entra.
Para um locatário do Azure AD B2C, esse método retorna um 200 OK código de resposta e uma coleção de objetos socialIdentityProvider ou appleManagedIdentityProvider no corpo da resposta.
Exemplos
Exemplo 1: Listar todos os recursos do provedor de identidade configurados em um locatário do Microsoft Entra
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/identity/identityProviders
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/identityProviders",
"value":[
{
"@odata.type": "microsoft.graph.builtInIdentityProvider",
"id": "MSASignup-OAUTH",
"identityProviderType": "MicrosoftAccount",
"displayName": "MicrosoftAccount"
},
{
"@odata.type": "#microsoft.graph.socialIdentityProvider",
"id": "Facebook-OAUTH",
"displayName": "Facebook",
"identityProviderType": "Facebook",
"clientId": "test",
"clientSecret": "******"
}
]
}
Exemplo 2: Listar todos os recursos do provedor de identidade configurados em um locatário do Azure AD B2C
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/identity/identityProviders
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/identityProviders",
"value": [
{
"@odata.type": "#microsoft.graph.socialIdentityProvider",
"id": "LinkedIn-OAUTH",
"displayName": "linkedin",
"identityProviderType": "LinkedIn",
"clientId": "866xc0qtyy00ih",
"clientSecret": "******"
},
{
"@odata.type": "#microsoft.graph.appleManagedIdentityProvider",
"id": "Apple-Managed-OIDC",
"displayName": "Sign in with Apple",
"developerId": "UBF8T346G9",
"serviceId": "com.microsoft.aad.b2c.iuyt.client",
"keyId": "99P6DD87C4",
"certificateData": "******"
}
]
}
Exemplo 3: Listar todos os provedores de identidade configurados em uma ID externa do Microsoft Entra em um locatário externo
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/identity/identityProviders
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/identityProviders",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET identity/identityProviders?$select=displayName",
"value": [
{
"@odata.type": "#microsoft.graph.builtInIdentityProvider",
"id": "AADSignup-OAUTH",
"displayName": "Azure Active Directory Sign up",
"identityProviderType": "AADSignup",
"state": null
},
{
"@odata.type": "#microsoft.graph.builtInIdentityProvider",
"id": "EmailOtpSignup-OAUTH",
"displayName": "Email One Time Passcode",
"identityProviderType": "EmailOTP",
"state": null
},
{
"@odata.type": "#microsoft.graph.builtInIdentityProvider",
"id": "EmailPassword-OAUTH",
"displayName": "Email with password",
"identityProviderType": "EmailPassword",
"state": null
}
]
}