Microsoft Graph 用 Go アプリにユーザー認証を追加する

この記事では、「 Microsoft Graph を使用してアプリをビルドする」で作成したアプリケーションにユーザー認証を追加します。次に、Microsoft Graph ユーザー API を使用して、認証されたユーザーを取得します。

ユーザー認証を追加する

Azure Identity Client Module for Go には、OAuth2 トークンフローを実装する多くのTokenCredential クラスが用意されています。 Microsoft Graph SDK for Go では、これらのクラスを使用して Microsoft Graph への呼び出しを認証します。

ユーザー認証用に Graph クライアントを構成する

まず、 DeviceCodeCredential クラスを使用して、デバイスコードフローを使用してアクセストークンを要求します。

次の関数を ./graphhelper/graphhelper.go に追加します。

func (g *GraphHelper) InitializeGraphForUserAuth() error {
    clientId := os.Getenv("CLIENT_ID")
    tenantId := os.Getenv("TENANT_ID")
    scopes := os.Getenv("GRAPH_USER_SCOPES")
    g.graphUserScopes = strings.Split(scopes, ",")

    // Create the device code credential
    credential, err := azidentity.NewDeviceCodeCredential(&azidentity.DeviceCodeCredentialOptions{
        ClientID: clientId,
        TenantID: tenantId,
        UserPrompt: func(ctx context.Context, message azidentity.DeviceCodeMessage) error {
            fmt.Println(message.Message)
            return nil
        },
    })
    if err != nil {
        return err
    }

    g.deviceCodeCredential = credential

    // Create an auth provider using the credential
    authProvider, err := auth.NewAzureIdentityAuthenticationProviderWithScopes(credential, g.graphUserScopes)
    if err != nil {
        return err
    }

    // Create a request adapter using the auth provider
    adapter, err := msgraphsdk.NewGraphRequestAdapter(authProvider)
    if err != nil {
        return err
    }

    // Create a Graph client using request adapter
    client := msgraphsdk.NewGraphServiceClient(adapter)
    g.userClient = client

    return nil
}

ヒント

goimportsを使用している場合は、graphhelper.go の import ステートメントから一部のモジュールが削除される場合があります。ビルドするには、モジュールをもう一度追加する必要がある場合があります。

graphtutorial.go の空のinitializeGraph関数を次のように置き換えます。

func initializeGraph(graphHelper *graphhelper.GraphHelper) {
    err := graphHelper.InitializeGraphForUserAuth()
    if err != nil {
        log.Panicf("Error initializing Graph for user auth: %v\n", err)
    }
}

このコードでは、 DeviceCodeCredential オブジェクトと GraphServiceClient オブジェクトの 2 つのプロパティを初期化します。 InitializeGraphForUserAuth関数は、DeviceCodeCredentialの新しいインスタンスを作成し、そのインスタンスを使用してGraphServiceClientの新しいインスタンスを作成します。 API 呼び出しが userClientを介して Microsoft Graph に対して行われるたびに、提供された資格情報を使用してアクセストークンを取得します。

DeviceCodeCredential をテストする

次に、 DeviceCodeCredentialからアクセストークンを取得するコードを追加します。

次の関数を ./graphhelper/graphhelper.go に追加します。

func (g *GraphHelper) GetUserToken() (*string, error) {
    token, err := g.deviceCodeCredential.GetToken(context.Background(), policy.TokenRequestOptions{
        Scopes: g.graphUserScopes,
    })
    if err != nil {
        return nil, err
    }

    return &token.Token, nil
}

graphtutorial.go の空のdisplayAccessToken関数を次のように置き換えます。

func displayAccessToken(graphHelper *graphhelper.GraphHelper) {
    token, err := graphHelper.GetUserToken()
    if err != nil {
        log.Panicf("Error getting user token: %v\n", err)
    }

    fmt.Printf("User token: %s", *token)
    fmt.Println()
}

go run graphtutorialを実行してアプリをビルドして実行します。オプションの入力を求められたら、「 1 」と入力します。アプリケーションに URL とデバイスコードが表示されます。

Go Graph Tutorial

Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. Make a Graph call
1
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and
enter the code RB2RUD56D to authenticate.

ブラウザーを開き、表示された URL を参照します。指定したコードを入力し、サインインします。

重要

https://microsoft.com/deviceloginを参照するときにブラウザーにログインしている既存の Microsoft 365 アカウントに注意してください。プロファイル、ゲストモード、プライベートモードなどのブラウザー機能を使用して、テストに使用するアカウントとして認証することを確認します。
完了したら、アプリケーションに戻り、アクセストークンを表示します。

ヒント

検証とデバッグ のみを目的として、 https://jwt.msで Microsoft のオンライントークンパーサーを使用してユーザーアクセストークンをデコードできます (職場または学校アカウントの場合のみ)。トークンの解析は、Microsoft Graph を呼び出すときにトークンエラーが発生した場合に役立ちます。たとえば、トークン内の scp 要求に、想定される Microsoft Graph アクセス許可スコープが含まれていることを確認します。

ユーザーを取得する

認証が構成されたので、最初の Microsoft Graph API呼び出しを行うことができます。認証されたユーザーの名前と電子メールアドレスを取得するコードを追加します。

次の関数を ./graphhelper/graphhelper.go に追加します。

func (g *GraphHelper) GetUser() (models.Userable, error) {
    query := users.UserItemRequestBuilderGetQueryParameters{
        // Only request specific properties
        Select: []string{"displayName", "mail", "userPrincipalName"},
    }

    return g.userClient.Me().Get(context.Background(),
        &users.UserItemRequestBuilderGetRequestConfiguration{
            QueryParameters: &query,
        })
}

graphtutorial.go の空のgreetUser関数を次のように置き換えます。

func greetUser(graphHelper *graphhelper.GraphHelper) {
    user, err := graphHelper.GetUser()
    if err != nil {
        log.Panicf("Error getting user: %v\n", err)
    }

    fmt.Printf("Hello, %s!\n", *user.GetDisplayName())

    // For Work/school accounts, email is in Mail property
    // Personal accounts, email is in UserPrincipalName
    email := user.GetMail()
    if email == nil {
        email = user.GetUserPrincipalName()
    }

    fmt.Printf("Email: %s\n", *email)
    fmt.Println()
}

アプリを今すぐ実行すると、サインインした後に名前で歓迎されます。

Hello, Megan Bowen!
Email: MeganB@contoso.com

コードの説明

getUser関数のコードについて考えてみましょう。ほんの数行ですが、注意する必要がある重要な詳細がいくつかあります。

'me' へのアクセス

関数は、Get user API への要求をビルドするuserClient.Me要求ビルダーを使用します。この API には、次の 2 つの方法でアクセスできます。

GET /me
GET /users/{user-id}

この場合、コードは GET /me API エンドポイントを呼び出します。このエンドポイントは、ユーザー ID を知らずに認証されたユーザーを取得するためのショートカットメソッドです。

注:

GET /me API エンドポイントは認証されたユーザーを取得するため、ユーザー認証を使用するアプリでのみ使用できます。アプリ専用認証アプリは、このエンドポイントにアクセスできません。

特定のプロパティの要求

関数は、要求のクエリパラメーターの Select プロパティを使用して、必要なプロパティのセットを指定します。このプロパティは、 $select クエリパラメーターを API 呼び出しに追加します。

厳密に型指定された戻り値の型

関数は、API からの JSON 応答から逆シリアル化された Userable オブジェクトを返します。コードでは Selectが使用されるため、返される Userable オブジェクトには、要求されたプロパティのみが値を持ちます。その他のすべてのプロパティには既定値があります。

次の手順

メールの読み取りと送信

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-06-12

Microsoft Graph 用 Go アプリにユーザー認証を追加する

ユーザー認証を追加する

ユーザー認証用に Graph クライアントを構成する

DeviceCodeCredential をテストする

ユーザーを取得する

コードの説明

'me' へのアクセス

特定のプロパティの要求

厳密に型指定された戻り値の型

次の手順

フィードバック

その他のリソース