Google Identity Services は FedCM API に移行します。移行ガイドに沿って潜在的な変更を確認し、ウェブサイトへのログインに悪影響が及ばないようにします。

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

サーバー側で Google ID トークンを確認する

Google が ID トークンを返すと、HTTP POST メソッドリクエストによって、パラメータ名 credential とともにログインエンドポイントに送信されます。

次の例は、ID トークンを検証して使用する一般的な手順を示しています。この例は Python 言語で記述されています。

クロスサイトリクエストフォージェリ（CSRF）トークンを検証します。ログインエンドポイントに認証情報を送信する際、Google はダブル送信 Cookie パターンを使用して CSRF 攻撃を防ぎます。送信のたびにトークンが生成されます。次に、次のコード例に示すように、トークンが Cookie と POST 本文の両方に配置されます。
```
csrf_token_cookie = self.request.cookies.get('g_csrf_token')
if not csrf_token_cookie:
    webapp2.abort(400, 'No CSRF token in Cookie.')
csrf_token_body = self.request.get('g_csrf_token')
if not csrf_token_body:
    webapp2.abort(400, 'No CSRF token in post body.')
if csrf_token_cookie != csrf_token_body:
    webapp2.abort(400, 'Failed to verify double submit cookie.')
```
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 type="x-smartling-placeholder">
</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 Auth 库。安装该库：
```
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 声明，该声明表示托管的用户的网域。将资源访问权限限制为仅允许成员访问时，必须使用此设置特定网域的用户缺少此声明即表示该账号不属于 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 声明。

如果您需要验证 ID 令牌是否代表 Google Workspace 或 Cloud 组织账号时，您可以查看 hd 声明，该声明表示托管的用户的网域。将资源访问权限限制为仅允许成员访问时，必须使用此设置特定网域的用户缺少此声明即表示该账号不属于 Google 托管的域。
。 <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 声明。您还必须验证 hd 检查 verify_oauth2_token 返回。如果多个客户端访问后端服务器，另请手动验证 aud 声明。
重要なポイント: ID トークンは、g_csrf_token フィールドではなく credential フィールドに返されます。
トークンの有効性が確認できたら、Google ID トークンの情報を使用して、サイトのアカウントステータスを関連付けることができます。
- 未登録のユーザー: 必要に応じて、ユーザーが追加のプロファイル情報を提供できる登録ユーザーインターフェース（UI）を表示できます。また、ユーザーは新しいアカウントとログイン中のユーザーセッションをサイレントで作成することもできます。
- サイトにすでに存在する既存のアカウント: エンドユーザーがパスワードを入力して、以前のアカウントを Google 認証情報にリンクできるウェブページを表示できます。これにより、ユーザーが既存のアカウントにアクセスできることを確認できます。
- 再びログインする連携ユーザー: ユーザーをサイレントログインできます。

サーバー側で Google ID トークンを確認する

使用 Google API 客户端库