Obtenir un fournisseur d’identité

Espace de noms: microsoft.graph

Obtenez les propriétés et les relations du fournisseur d’identité spécifié configuré dans le locataire.

Parmi les types de fournisseurs dérivés d’identityProviderBase, vous pouvez actuellement obtenir une ressource socialIdentityProvider ou builtinIdentityProvider dans Azure AD. Dans Azure AD B2C, cette opération peut actuellement obtenir une ressource socialIdentityProvider ou appleManagedIdentityProvider .

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	IdentityProvider.Read.All, IdentityProvider.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	IdentityProvider.Read.All, IdentityProvider.ReadWrite.All

Le compte professionnel ou scolaire doit appartenir à l’un des rôles suivants :

• Administrateur général
• Administrateur du fournisseur d’identité externe
• Administrateur de flux d’utilisateur d’ID externe

Requête HTTP

GET /identity/identityProviders/{id}

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et une représentation JSON d’un socialIdentityProvider ou d’un builtinIdentityProvider dans le corps de la réponse pour un locataire Azure AD.

Pour un locataire Azure AD B2C, cette méthode renvoie un 200 OK code de réponse et une représentation JSON d’un objet socialIdentityProvider ou appleManagedIdentityProvider dans le corps de la réponse.

Exemples

Exemple 1 : Récupérer un fournisseur d’identité sociale spécifique (Azure AD ou Azure AD B2C)

Demande

Voici un exemple de demande.

HTTP

GET https://graph.microsoft.com/v1.0/identity/identityProviders/Amazon-OAUTH

C#

// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

var result = await graphClient.Identity.IdentityProviders["{identityProviderBase-id}"].GetAsync();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



result, err := graphClient.Identity().IdentityProviders().ByIdentityProviderId("identityProviderBase-id").Get(context.Background(), nil)

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

IdentityProviderBase identityProviderBase = graphClient.identity().identityProviders("Amazon-OAUTH")
	.buildRequest()
	.get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let identityProviderBase = await client.api('/identity/identityProviders/Amazon-OAUTH')
	.get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);


$result = $graphServiceClient->identity()->identityProviders()->byIdentityProviderId('identityProviderBase-id')->get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PowerShell

Import-Module Microsoft.Graph.Identity.SignIns

Get-MgIdentityProvider -IdentityProviderBaseId $identityProviderBaseId

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "Amazon-OAUTH",
    "displayName": "Amazon",
    "identityProviderType": "Amazon",
    "clientId": "09876545678908765978678",
    "clientSecret": "******"
}

Exemple 2 : Récupérer un fournisseur d’identité intégré spécifique (uniquement pour Azure AD)

Demande

Voici un exemple de demande.

HTTP

GET https://graph.microsoft.com/v1.0/identity/identityProviders/MSASignup-OAUTH

C#

// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

var result = await graphClient.Identity.IdentityProviders["{identityProviderBase-id}"].GetAsync();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



result, err := graphClient.Identity().IdentityProviders().ByIdentityProviderId("identityProviderBase-id").Get(context.Background(), nil)

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

IdentityProviderBase identityProviderBase = graphClient.identity().identityProviders("MSASignup-OAUTH")
	.buildRequest()
	.get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let identityProviderBase = await client.api('/identity/identityProviders/MSASignup-OAUTH')
	.get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);


$result = $graphServiceClient->identity()->identityProviders()->byIdentityProviderId('identityProviderBase-id')->get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PowerShell

Import-Module Microsoft.Graph.Identity.SignIns

Get-MgIdentityProvider -IdentityProviderBaseId $identityProviderBaseId

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "MSASignup-OAUTH",
    "identityProviderType": "MicrosoftAccount",
    "displayName": "MicrosoftAccount"
}

Exemple 3 : récupère le fournisseur d’identité Apple (uniquement pour Azure AD B2C)

Demande

Voici un exemple de demande.

HTTP

GET https://graph.microsoft.com/v1.0/identity/identityProviders/Apple-Managed-OIDC

C#

// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

var result = await graphClient.Identity.IdentityProviders["{identityProviderBase-id}"].GetAsync();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



result, err := graphClient.Identity().IdentityProviders().ByIdentityProviderId("identityProviderBase-id").Get(context.Background(), nil)

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

IdentityProviderBase identityProviderBase = graphClient.identity().identityProviders("Apple-Managed-OIDC")
	.buildRequest()
	.get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let identityProviderBase = await client.api('/identity/identityProviders/Apple-Managed-OIDC')
	.get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);


$result = $graphServiceClient->identity()->identityProviders()->byIdentityProviderId('identityProviderBase-id')->get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PowerShell

Import-Module Microsoft.Graph.Identity.SignIns

Get-MgIdentityProvider -IdentityProviderBaseId $identityProviderBaseId

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "Apple-Managed-OIDC",
    "displayName": "Sign in with Apple",
    "developerId": "UBF8T346G9",
    "serviceId": "com.microsoft.rts.b2c.test.client",
    "keyId": "99P6D879C4",
    "certificateData": "******"
}