このページは Cloud Translation API によって翻訳されました。

ID トークンを使用してバックエンドで認証する

ワンタップログインクライアントは、ユーザーが Google アカウント。ID トークンはユーザー ID の署名付きアサーションであり、ユーザーの基本的なプロフィール情報（メールアドレスなど）が含まれているメッセージを表示できます。

ID トークンが利用可能な場合、それらを使用して安全に認証を行うことができます。新しいアカウントを自動的に作成する場合や、ユーザーのメールアドレスを確認する必要はありません。

ID トークンを使用してユーザーのログインや登録を行うには、トークンをアプリケーションのバックエンドです。バックエンドで、Google API クライアントまたは API クライアントを使用してトークンを検証するまたは汎用の JWT ライブラリを使用できます。ユーザーがニュースメディアにログインしたことがない場合、この Google アカウントでアプリを使用するには、新しいアカウントを作成してください。

リプレイ攻撃を回避するためにノンスを使用することを選択した場合は、次のコマンドを使用します。 getNonce このトークンを ID トークンとともにバックエンドサーバーに送信し、示します。メッセージにノンスを使用することを強くおすすめします。ユーザーの安全性とセキュリティを向上させることができます

認証情報オブジェクトから ID トークンを取得する

ユーザーの認証情報を取得したら、認証情報オブジェクトが ID トークンが含まれています。発生した場合は、バックエンドに送信します。

Java

public class YourActivity extends AppCompatActivity {

  // ...
  private static final int REQ_ONE_TAP = 2;  // Can be any integer unique to the Activity.
  private boolean showOneTapUI = true;
  // ...

  @Override
  protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
      super.onActivityResult(requestCode, resultCode, data);

      switch (requestCode) {
          case REQ_ONE_TAP:
              try {
                  SignInCredential credential = oneTapClient.getSignInCredentialFromIntent(data);
                  String idToken = credential.getGoogleIdToken();
                  if (idToken !=  null) {
                      // Got an ID token from Google. Use it to authenticate
                      // with your backend.
                      Log.d(TAG, "Got ID token.");
                  }
              } catch (ApiException e) {
                  // ...
              }
              break;
      }
  }
}

Kotlin

class YourActivity : AppCompatActivity() {

    // ...
    private val REQ_ONE_TAP = 2  // Can be any integer unique to the Activity
    private var showOneTapUI = true
    // ...

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)

        when (requestCode) {
             REQ_ONE_TAP -> {
                try {
                    val credential = oneTapClient.getSignInCredentialFromIntent(data)
                    val idToken = credential.googleIdToken
                    when {
                        idToken != null -> {
                            // Got an ID token from Google. Use it to authenticate
                            // with your backend.
                            Log.d(TAG, "Got ID token.")
                        }
                        else -> {
                            // Shouldn't happen.
                            Log.d(TAG, "No ID token!")
                        }
                    }
                } catch (e: ApiException) {
                    // ...
            }
        }
    }
    // ...
}

ID トークンの整合性を確認する

HTTPS POST で ID トークンを受信したら、完全性を検証する必要があります。渡されます。

トークンが有効であることを確認するには、次のことを確認します。条件が満たされます。

ID トークンが Google によって適切に署名されている。Google の公開鍵を使用する（ JWK または PEM 形式）トークンの署名を検証します。これらの鍵は定期的にローテーションされます。調べるレスポンスの Cache-Control ヘッダーを使用して、再度取得する必要があります
ID トークンの aud の値がアプリのいずれかの値と等しいクライアント ID などがあります。このチェックは、悪意のあるクライアントに ID トークンを発行するのを防ぐために必要です。アプリが、アプリのバックエンドサーバー上の同一ユーザーに関するデータにアクセスするために使用されています。
ID トークンの iss の値は次と等しい accounts.google.com または https://accounts.google.com。
ID トークンの有効期限（exp）を過ぎていない。
ID トークンが Google Workspace または Cloud 組織アカウントの場合は、hd クレームを確認できます。これは、ホストされている Pod がユーザーのドメインです。これは、リソースへのアクセスをそのメンバーのみに制限する場合にできます。このクレームがない場合、アカウントは Google がホストするドメイン。

email、email_verified、hd フィールドを使用して、 Google はメールアドレスをホストし、その権威があります。Google が信頼できる場合、そのユーザーが正当なアカウント所有者であることがわかっているため、パスワードやその他の確認しましょう。

Google が信頼できるケース:

email には @gmail.com という接尾辞が付いています。これは Gmail アカウントです。
email_verified は true で、hd が設定されています。これは G Suite アカウントです。

ユーザーは Gmail や G Suite を使用せずに Google アカウントを登録できます。日時 email に @gmail.com という接尾辞がなく、hd が存在しないと、Google にはありません。認証には、信頼できる認証方法、パスワード、その他の本人確認方法を使用することが推奨されます。できます。email_verified も、Google が最初に検証したユーザーに付与できますが、サードパーティの所有権が付与されます。アカウントが変更された可能性があります。

これらの検証ステップを実行するために独自のコードを記述するのではなく、プラットフォームに適した Google API クライアントライブラリを使用するか、 JWT ライブラリ。開発とデバッグの場合は、tokeninfo を呼び出すことができます。検証エンドポイントを指定します。

Google API クライアントライブラリの使用

Google API クライアントライブラリのいずれか（ Java、 Node.js、 PHP、 Python など）は、本番環境で Google ID トークンを検証する場合におすすめの方法です。

</ph> <ph type="x-smartling-placeholder">

</ph>

Java

Java で ID トークンを検証するには、 GoogleIdTokenVerifier オブジェクトです。例:

import com.google.api.client.googleapis.auth.oauth2.GoogleIdToken;
import com.google.api.client.googleapis.auth.oauth2.GoogleIdToken.Payload;
import com.google.api.client.googleapis.auth.oauth2.GoogleIdTokenVerifier;

...

GoogleIdTokenVerifier verifier = new GoogleIdTokenVerifier.Builder(transport, jsonFactory)
    // Specify the CLIENT_ID of the app that accesses the backend:
    .setAudience(Collections.singletonList(CLIENT_ID))
    // Or, if multiple clients access the backend:
    //.setAudience(Arrays.asList(CLIENT_ID_1, CLIENT_ID_2, CLIENT_ID_3))
    .build();

// (Receive idTokenString by HTTPS POST)

GoogleIdToken idToken = verifier.verify(idTokenString);
if (idToken != null) {
  Payload payload = idToken.getPayload();

  // Print user identifier
  String userId = payload.getSubject();
  System.out.println("User ID: " + userId);

  // Get profile information from payload
  String email = payload.getEmail();
  boolean emailVerified = Boolean.valueOf(payload.getEmailVerified());
  String name = (String) payload.get("name");
  String pictureUrl = (String) payload.get("picture");
  String locale = (String) payload.get("locale");
  String familyName = (String) payload.get("family_name");
  String givenName = (String) payload.get("given_name");

  // Use or store profile information
  // ...

} else {
  System.out.println("Invalid ID token.");
}

GoogleIdTokenVerifier.verify() メソッドで JWT を検証する署名、aud クレーム、iss クレーム、 exp の申し立て。

ID トークンが Google Workspace または Cloud 組織アカウントの場合は、ドメイン名を確認することで hd クレームを確認できます。 Payload.getHostedDomain() メソッドが返す値。ドメインのアカウントがドメインによって管理されていることを確認するには email 申請では不十分ですできます。

で確認できます。 <ph type="x-smartling-placeholder">

</ph>

Node.js

Node.js で ID トークンを検証するには、Node.js 用 Google 認証ライブラリを使用します。ライブラリをインストールします。

npm install google-auth-library --save

次に、verifyIdToken() 関数を呼び出します。例:

const {OAuth2Client} = require('google-auth-library');
const client = new OAuth2Client();
async function verify() {
  const ticket = await client.verifyIdToken({
      idToken: token,
      audience: CLIENT_ID,  // Specify the CLIENT_ID of the app that accesses the backend
      // Or, if multiple clients access the backend:
      //[CLIENT_ID_1, CLIENT_ID_2, CLIENT_ID_3]
  });
  const payload = ticket.getPayload();
  const userid = payload['sub'];
  // If the request specified a Google Workspace domain:
  // const domain = payload['hd'];
}
verify().catch(console.error);

verifyIdToken 関数は、以下を確認します。 JWT 署名、aud クレーム、exp クレーム、 iss クレーム。

ID トークンが Google Workspace または Cloud 組織アカウントの場合は、hd クレームを確認できます。これは、ホストされている Pod がユーザーのドメインです。これは、リソースへのアクセスをメンバーのみに制限する場合に使用します特定のドメインのこの申し立てがない場合は、アカウントが Google がホストするドメインです。

で確認できます。 <ph type="x-smartling-placeholder">

</ph>

PHP

PHP で ID トークンを検証するには、PHP 用の Google API クライアントライブラリを使用します。ライブラリをインストールします（Composer を使用するなど）。

composer require google/apiclient

次に、verifyIdToken() 関数を呼び出します。例:

require_once 'vendor/autoload.php';

// Get $id_token via HTTPS POST.

$client = new Google_Client(['client_id' => $CLIENT_ID]);  // Specify the CLIENT_ID of the app that accesses the backend
$payload = $client->verifyIdToken($id_token);
if ($payload) {
  $userid = $payload['sub'];
  // If the request specified a Google Workspace domain
  //$domain = $payload['hd'];
} else {
  // Invalid ID token
}

verifyIdToken 関数は、以下を確認します。 JWT 署名、aud クレーム、exp クレーム、 iss クレーム。

で確認できます。 <ph type="x-smartling-placeholder">

</ph>

Python

Python で ID トークンを検証するには、 verify_oauth2_token 使用します。例:

from google.oauth2 import id_token
from google.auth.transport import requests

# (Receive token by HTTPS POST)
# ...

try:
    # Specify the CLIENT_ID of the app that accesses the backend:
    idinfo = id_token.verify_oauth2_token(token, requests.Request(), CLIENT_ID)

    # Or, if multiple clients access the backend server:
    # idinfo = id_token.verify_oauth2_token(token, requests.Request())
    # if idinfo['aud'] not in [CLIENT_ID_1, CLIENT_ID_2, CLIENT_ID_3]:
    #     raise ValueError('Could not verify audience.')

    # If the request specified a Google Workspace domain
    # if idinfo['hd'] != DOMAIN_NAME:
    #     raise ValueError('Wrong domain name.')

    # ID token is valid. Get the user's Google Account ID from the decoded token.
    userid = idinfo['sub']
except ValueError:
    # Invalid token
    pass

verify_oauth2_token 関数で JWT を検証する aud クレーム、exp クレームの 3 つが存在します。 hd も確認する必要があります（該当する場合は）そのオブジェクトを調べ、 verify_oauth2_token が返品可能。複数のクライアントが aud クレームも手動で検証します。

tokeninfo エンドポイントの呼び出し

デバッグ用の ID トークンの署名を検証する簡単な方法は次のとおりです。 tokeninfo エンドポイントを使用する。このエンドポイントを呼び出すには、追加のネットワークリクエストを作成し、適切なテストを行いながら、検証の大部分を担います。独自のコードで検証とペイロード抽出を行えます本番環境での使用には適していないリクエストが抑制される可能性があります。また、断続的なエラーが発生することがあります。

tokeninfo エンドポイントを使用して ID トークンを検証するには、HTTPS を使用します。 POST または GET リクエストをエンドポイントに送信し、 id_token パラメータ。たとえば、トークン「XYZ123」を検証するには、次の GET リクエストを行います。

https://oauth2.googleapis.com/tokeninfo?id_token=XYZ123

トークンが適切に署名されていて、iss と exp が要求に期待値がある場合、HTTP 200 レスポンスが返されます。 JSON 形式の ID トークンクレームが含まれています。以下はレスポンスの例です。

{
 // These six fields are included in all Google ID Tokens.
 "iss": "https://accounts.google.com",
 "sub": "110169484474386276334",
 "azp": "1008719970978-hb24n2dstb40o45d4feuo2ukqmcc6381.apps.googleusercontent.com",
 "aud": "1008719970978-hb24n2dstb40o45d4feuo2ukqmcc6381.apps.googleusercontent.com",
 "iat": "1433978353",
 "exp": "1433981953",

 // These seven fields are only included when the user has granted the "profile" and
 // "email" OAuth scopes to the application.
 "email": "testuser@gmail.com",
 "email_verified": "true",
 "name" : "Test User",
 "picture": "https://lh4.googleusercontent.com/-kYgzyAWpZzJ/ABCDEFGHI/AAAJKLMNOP/tIXL9Ir44LE/s99-c/photo.jpg",
 "given_name": "Test",
 "family_name": "User",
 "locale": "en"
}

警告: 申請を受けた場合でも、 aud クレームにアプリのクライアント ID のいずれかが含まれていることを確認します。発生した場合、このトークンは有効で、クライアントに意図されたものであると判断されるため、トークンを安全に取得して使用できます。 sub クレームからのユーザーの一意の Google ID。

ID トークンが Google Workspace アカウントを表していることを検証する必要がある場合は、 hd クレーム。これは、ユーザーのホストドメインを示します。これは次の場合に使用する必要があります。リソースへのアクセスを特定のドメインのメンバーのみに制限する。この主張がないことは、アカウントが Google Workspace でホストされているドメインに属していないことを示します。

アカウントまたはセッションを作成する

トークンを確認したら、ユーザーがすでにユーザーに含まれているかどうかを確認するデータベースですその場合は、ユーザーの認証済みセッションを確立します。ユーザーがまだユーザーデータベースにない場合は、情報から新しいユーザーレコードを作成します。を ID トークンペイロード内で指定し、ユーザーのセッションを確立します。このプロンプトを追加のプロファイル情報をユーザーに送信するには、ユーザーを追加します。

ユーザーの安全をクロスアカウント保護機能が有効なアカウント

ユーザーのログインを Google に任せると、自動的にユーザーのデータを保護するために Google が構築したセキュリティ機能とインフラストラクチャです。ただし、万一、ユーザーの Google アカウントが不正使用された場合や、重大なセキュリティイベントが発生した場合、アプリは攻撃に対して脆弱になる可能性もあります。お客様のデータを使用する必要がある場合は、クロスアカウントを使用して保護: Google からセキュリティ通知を受け取れます。これらのイベントを受信すると、ユーザーの Google アカウントのセキュリティに関する重要な変更に対する可視性を得る。アカウントを保護するための措置を講じることができます。

ID トークンを使用してバックエンドで認証する

認証情報オブジェクトから ID トークンを取得する

Java

Kotlin

ID トークンの整合性を確認する

Google API クライアント ライブラリの使用

tokeninfo エンドポイントの呼び出し

アカウントまたはセッションを作成する

ユーザーの安全をクロスアカウント保護機能が有効なアカウント

Google API クライアントライブラリの使用