制限付きスコープの検証

一部の Google API( 機密性の高いスコープや 制限付き スコープを受け入れるもの)には、ユーザーデータへのアクセス権をリクエストするアプリに関する要件があります。 制限付きスコープに関するこれらの追加要件 では、アプリが許可されたアプリケーション タイプであることを証明し、 追加の審査を受ける必要があります。これには、セキュリティ評価が含まれる場合があります。

API 内で制限付きスコープが適用されるかどうかは、アプリで関連する機能を提供するために必要なアクセス権の程度(読み取り専用、書き込み専用、読み取りと書き込みなど)によって異なります。

OAuth 2.0 を使用して Google アカウントからこのデータへのアクセス権を取得する場合は、スコープと呼ばれる文字列を使用して、アクセスするデータの種類と必要なアクセス権の程度を指定します。 アプリが 機密性の高い スコープや 制限付き スコープをリクエストする場合は、アプリの使用が 例外に該当しない限り、確認プロセスを完了する必要があります。

制限付きスコープは、機密性の高いスコープに比べて数が少なくなっています。 OAuth API の確認 に関するよくある質問には、機密性の高いスコープと制限付きスコープの現在のリストが記載されています。これらのスコープは Google ユーザーデータへの幅広いアクセスを提供するため、Google アカウントからスコープをリクエストする前に、スコープの確認プロセスを完了する必要があります。この要件について詳しくは、 Google API サービスのユーザーデータに関するポリシー特定の API スコープの追加要件 、またはプロダクト固有の Google デベロッパー ページ をご覧ください。制限付きスコープのデータをサーバーに保存または送信する場合は、 セキュリティ評価を完了する必要があります。


制限付きスコープについて

アプリが制限付きスコープをリクエストし、例外に該当しない場合は、Google API サービスのユーザーデータに関するポリシーの特定の API スコープの追加要件、またはプロダクトのGoogle デベロッパー ページのプロダクト固有の要件を満たす必要があります。これには、より広範な審査プロセスが必要です。

スコープの使用状況を把握する

  • アプリで使用しているスコープ、または使用したいスコープを確認します。既存のスコープの使用状況を確認するには、アプリのソースコードで、認可リクエストとともに送信されるスコープを確認します。
  • リクエストされた各スコープが、アプリの機能の目的のアクションに必要であり、機能を提供するために必要な最小権限を使用していることを確認します。通常、Google API には、エンドポイントを呼び出すために必要なスコープや、エンドポイント内の特定のプロパティを含む、プロダクトの Google デベロッパー ページにエンドポイントのリファレンス ドキュメントが用意されています。アプリが呼び出す API エンドポイントに必要なアクセス スコープについて詳しくは、それらのエンドポイントのリファレンス ドキュメントをご覧ください。たとえば、Gmail API のみを使用してユーザーに代わってメールを送信するアプリの場合は、ユーザーのメールデータへのフルアクセスを提供するスコープをリクエストしないでください。
  • Google API から受け取ったデータは、API のポリシーに準拠し、アプリのアクションとプライバシー ポリシーでユーザーに提示する方法でのみ使用する必要があります。
  • API ドキュメントを参照して、各スコープの詳細( その潜在的な 機密性の高い ステータスまたは制限付きステータスなど)をご確認ください。
  • アプリで使用するすべてのスコープを、Cloud Console の [データアクセス] ページで宣言します。指定したスコープは、機密性の高いカテゴリまたは制限付きカテゴリにグループ化され、必要な追加の確認がハイライト表示されます。
  • 統合で使用するデータに最適なスコープを見つけ、その使用方法を把握し、テスト環境ですべてが正常に動作することを確認してから、確認のために送信する準備をします。

アプリや、新しいスコープを必要とする新機能のリリース計画には、確認を完了するのに必要な時間を考慮してください。これらの追加要件の 1 つは、アプリがサーバーから、またはサーバー経由で Google ユーザーデータにアクセスする場合、またはアクセスできる場合です。このような場合、システムは Google が承認した独立した第三者評価者による年次のセキュリティ評価を受ける必要があります。そのため、制限付きスコープの確認プロセスには数週間かかることがあります。最後の承認済み OAuth 同意画面の確認以降にブランディング情報が 変更された場合は、まずブランド 確認 の手順を完了する必要があります。通常、これには 2 ~ 3 営業日かかります。


許可されるアプリケーション タイプ

特定のアプリケーション タイプは、各プロダクトの制限付きスコープにアクセスできます。アプリケーション タイプは、プロダクト固有の Google Developer Page(Gmail API ポリシーなど)で確認できます。

アプリケーション タイプを理解して判断することは、お客様の責任です。 ただし、アプリのアプリケーション タイプが不明な場合は、アプリを確認のために送信するときに、[使用する機能] の質問でオプションを選択しないでください。Google API の確認チームがアプリケーション タイプを判断します。


セキュリティ評価

Google ユーザーの制限付きデータへのアクセスをリクエストし、サードパーティ サーバーから、またはサードパーティ サーバー経由でデータにアクセスできるアプリはすべて、Google が任命したセキュリティ評価者によるセキュリティ評価を受ける必要があります。この評価は、Google ユーザーデータにアクセスするすべてのアプリが、データを安全に処理し、ユーザーのリクエストに応じてユーザーデータを削除する機能を備えていることを確認することで、Google ユーザーのデータを安全に保つために役立ちます。

セキュリティ評価を標準化するために、App Defense Alliancecloud application security assessment framework (CASA)を使用しています。

前述のように、確認済みの制限付きスコープへのアクセスを維持するには、評価者の評価文書(LOA)の承認日から少なくとも 12 か月ごとに、アプリの準拠状況を再確認し、セキュリティ評価を完了する必要があります。 アプリに新しい制限付きスコープを追加した場合、以前のセキュリティ評価に含まれていない場合は、追加のスコープを対象とするためにアプリの再評価が必要になることがあります。

アプリの再認証が必要になると、Google の審査チームからメールが届きます。この年次の違反措置についてチームの適切なメンバーに通知されるようにするには、オーナーまたは編集者として追加の Google アカウントを Cloud Console プロジェクトに関連付けます。また、Google Cloud コンソール の OAuth ブランディング ページで指定されているユーザー サポートとデベロッパーの連絡先メールアドレスを最新の状態に保つことも重要です。


確認の準備手順

Google API を使用してデータへのアクセスをリクエストするすべてのアプリは、ブランディングの確認を完了するために次の手順を行う必要があります。

  1. アプリが 確認要件の例外セクションに記載されているユースケースに該当しないことを確認します。
  2. アプリが、関連する API またはプロダクトのブランディング要件に準拠していることを確認します。たとえば、ブランディング ガイドラインについては、Google ログイン スコープをご覧ください。
  3. Google Search Console でプロジェクトの承認済みドメイン のオーナー権限を確認します。API Console プロジェクトに関連付けられている Google アカウントをオーナーまたは編集者として使用します。
  4. OAuth 同意画面のすべてのブランディング情報(アプリ名、サポートメール、ホームページの URI、プライバシー ポリシーの URI など)が、アプリのアイデンティティを正確に表していることを確認します。

アプリケーションのホームページの要件

ホームページが次の要件を満たしていることを確認します。

  • ホームページは一般公開されており、サイトにログインしているユーザーのみがアクセスできるものではありません。
  • 審査対象のアプリとホームページの関連性が明確である必要があります。
  • Google Play ストアのアプリの掲載情報や Facebook ページへのリンクは、有効なアプリケーションのホームページとは見なされません。

アプリケーション プライバシー ポリシーのリンクの要件

アプリのプライバシー ポリシーが次の要件を満たしていることを確認します。

  • プライバシー ポリシーはユーザーに表示され、アプリケーションのホームページと同じドメイン内でホストされ、Google API Console の OAuth 同意画面にリンクされている必要があります。ホームページには、アプリの機能の説明と、プライバシー ポリシーおよびオプションの利用規約へのリンクを含める必要があります。
  • プライバシー ポリシーでは、アプリケーションが Google ユーザーデータにアクセスし、それらを使用、保存、共有する仕組みを開示する必要があります。 The privacy policy must comply with the Google API Services User Data Policy and the Limited Use requirements for restricted scopes. デベロッパーによる Google ユーザー データの使用は、公開しているプライバシー ポリシーで開示されている取り扱いに限定される必要があります。
  • * Review example cases of privacy policies that don't meet the Limited Use requirements.

ブランディングの確認のためにアプリを送信する方法

Google Cloud コンソール プロジェクトは、Cloud コンソール のすべてのリソースを整理します。プロジェクトは、プロジェクト オペレーションを実行する権限を持つ関連する Google アカウントのセット、有効な API のセット、それらの API の課金、認証、モニタリングの設定で構成されます。たとえば、プロジェクトには 1 つ以上の OAuth クライアントを含めることができ、それらのクライアントで使用する API を構成し、ユーザーがアプリへのアクセスを承認する前に表示される OAuth 同意画面 を構成できます。

OAuth クライアントが本番環境に対応していない場合は、確認をリクエストしているプロジェクトから削除することをおすすめします。これは、[クライアント]ページで行うことができます。

確認のために送信する手順は次のとおりです。

  1. アプリが Google API の利用規約Google API サービスのユーザーデータに関するポリシーに準拠していることを確認します。
  2. Cloud Console で、プロジェクトに関連付けられているアカウントのオーナーと編集者のロール、OAuth 同意画面のユーザー サポートのメールアドレス、デベロッパーの連絡先情報を最新の状態に保ちます。これにより、新しい要件がチームの適切なメンバーに通知されます。
  3. Cloud Console の OAuth ブランディング ページに移動します。
  4. [プロジェクト セレクタ] ボタンをクリックします。
  5. [選択元] ダイアログが表示されたら、プロジェクトを選択します。プロジェクトが見つからないがプロジェクト ID がわかっている場合は、ブラウザで次の形式で URL を作成できます。
    https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
    Replace [PROJECT_ID] with the project ID you want to use.
  6. [ブランディング] ページで、アプリのブランディング情報(アプリ名、ロゴ、デベロッパーの連絡先情報、関連リンクなど)を入力します。加えた変更はすべて [ブランディングの下書き] として保存されます。
  7. [ブランディングを確認] ボタンをクリックして、評価プロセスを開始します。通常、自動システムによる審査は数分で完了します。
  8. 評価が完了したら、ステータスを確認します。成功すると、ステータスは [公開の準備ができました] に変わります。自動確認が失敗した場合は、検出された問題を確認し、修正するか、個別審査をリクエストできます。
  9. [ブランディングを公開] ボタンをクリックして、新しいブランディングを公開します。
  10. アプリで機密性の高いスコープや制限付きスコープの確認も必要な場合は、OAuth [確認センター] に移動して [データアクセス ステータス] を確認し、デモ動画など、リクエストされた追加情報を提供します。データアクセスの確認をリクエストするには、ブランディングのステータスが公開されている必要があります。
  11. [スコープを追加または削除] ボタンを使用して、アプリがリクエストするすべてのスコープを宣言します。Google ログインに必要なスコープの初期セットは、[機密性の高いスコープ以外] セクションに事前入力されています。追加されたスコープは、機密性の高いスコープ以外として分類されます sensitive, or restricted 。
  12. アプリの関連機能に関する関連ドキュメントへのリンクを最大 3 つ入力します。
  13. 以降の手順で、アプリに関する追加情報を入力します。 1. Ensure your app complies with the Additional requirements for specific API scopes, which includes undergoing an annual security assessment if your app accesses restricted scope Google users' data from or through a third-party server. 2. Ensure your app is one of the allowed types specified in the Limited Use section of the Additional requirements for specific API scopes page. 3. If your app is a task automation platform, your demonstration video must showcase how multiple API workflows are created and automated, and in which directions user data flows. 4. Prepare a video that fully demonstrates how a user initiates and grants access to the requested scopes and shows, in detail, the usage of the granted sensitive and restricted scopes in the app. Upload the video to YouTube Studio and set Visibility as Unlisted. You need to provide a link to the demonstration video in the YouTube link field. 1. Show the OAuth grant process that users will experience, in English. This includes the consent flow and, if you use Google Sign-In, the sign-in flow. 2. Show that the OAuth consent screen correctly displays the App Name. 3. Show that the browser address bar of the OAuth consent screen correctly includes your app's OAuth client ID. 4. To show how the data will be used, demonstrate the functionality that's enabled by each sensitive and restricted scope that you request. 5. If you use multiple clients, and therefore have multiple OAuth client IDs, show how the data is accessed on each OAuth client. 5. Select your permitted application type from the "What features will you use?" list. 6. Describe how you will use the restricted scopes in your app and why more limited scopes aren't sufficient.

ブランディングを公開するか、データアクセス リクエストを送信すると、Google の Trust & Safety チームから、必要な追加情報や完了する必要がある手順についてメールで連絡が届くことがあります。[デベロッパーの連絡先情報] セクションと OAuth 同意画面のサポートメールアドレスで、追加情報のリクエストを確認してください。プロジェクトの [ブランディング] ページまたは [確認センター] ページで、プロジェクトの現在の審査ステータス(返信を待っている間、審査プロセスが一時停止しているかどうかなど)を確認することもできます。

確認要件の例外

アプリが次のセクションで説明するシナリオで使用される場合は、審査のために送信する必要はありません。

個人的な利用

ユースケースの 1 つは、アプリのユーザーが自分だけの場合、またはアプリを使用するユーザーが数名で、全員が個人的に知っている場合です。自分と少数のユーザーは、未確認アプリの画面を進み、個人アカウントにアプリへのアクセス権を付与しても問題ないかもしれません。

開発、テスト、ステージングの各階層で使用されるプロジェクト

Google OAuth 2.0 ポリシーに準拠するため、テスト環境と本番環境で異なるプロジェクトを使用することをおすすめします。Google アカウントを持つすべてのユーザーがアプリを利用できるようにする場合にのみ、アプリを確認のために送信することをおすすめします。したがって、アプリが開発、テスト、ステージングの段階にある場合は、確認は必要ありません。

アプリが開発段階またはテスト段階にある場合は、[公開ステータス] をデフォルト設定の [**テスト**] のままにできます。この設定は、アプリがまだ開発中であり、テストユーザーのリストに追加したユーザーのみが利用できることを意味します。アプリの開発またはテストに関与する Google アカウントのリストを管理する必要があります。

テスト中のアプリが Google で確認されていないことを示す警告メッセージ。
図 1.テスター警告画面

サービス所有のデータのみ

アプリがサービス アカウントを使用して独自のデータにのみアクセスし、ユーザーデータ(Google アカウントにリンクされている)にアクセスしない場合は、確認のために送信する必要はありません。

サービス アカウントの詳細については、Google Cloud のドキュメントのサービス アカウントをご覧ください。サービスアカウントの使用方法については、サーバー間アプリケーションに OAuth 2.0 を使用するをご覧ください。

社内専用

これは、アプリが Google Workspace または Cloud Identity 組織のユーザーのみによって使用されることを意味します。プロジェクトは組織が所有し、OAuth 同意画面は [**内部**] ユーザータイプ用に構成する必要があります。この場合、アプリには組織管理者の承認が必要になることがあります。詳しくは、Google Workspace の追加の考慮事項をご覧ください。

ドメイン全体のインストール

アプリが Google Workspace または Cloud Identity 組織のユーザーのみを対象とし、常に ドメイン全体のインストール を使用する場合は、アプリのブランディングの確認は必要ありません。ただし、アプリが制限付きスコープまたは機密性の高いスコープを使用する場合は、アプリの確認が必要です。これは、ドメイン全体のインストールにより、ドメイン管理者がサードパーティ製アプリと内部アプリにユーザーのデータへのアクセスを許可できるためです。組織管理者は、ドメイン内で使用するアプリを許可リストに追加できる唯一のアカウントです。

アプリをドメイン全体のインストールにする方法については、よくある質問の「私のアプリケーションには、別の Google Workspace ドメインの企業アカウントを持つユーザーがいます」をご覧ください。