イベント、訪問、またはデータレコード機能に認証を追加する

イベントや訪問の機能では、FacebookやGoogleなどのサービスプロバイダーにアクセスするために認証が必要になることがあります。機能に認証を追加するには、サービスプロバイダーのアカウントを持っている必要があります。

仕組み

機能に認証を追加すると、アクセストークンが生成され、コードエディタの詳細タブに表示されます。その名前を指定してください。この認証は、その名前をhelper.getAuth()に渡すことで機能内でアクセスできます。

認証トークンはHTTPリクエスト内の機能からのみ参照できます。HTTPリクエストの外でトークンを参照しようとすると、トークンはUUIDプレースホルダーに置き換えられます。これは、トークンへの不正アクセスを防ぐための制限です。

例えば、firebase_cloud_messagingという名前のアクセストークンで認証を作成した場合、HTTPリクエストを使用して機能内でそのトークンにアクセスするには、helper.getAuth('firebase_cloud_messaging')を使用します。この機能は、認証されたエンドポイントへのリクエストを行う際に認証ヘッダーを構成するために一般的に使用されます：

activate(async ({ visitor, helper }) => {
  const response = await fetch(
    "https://fcm.googleapis.com/v1/projects/YOURPROJECT/messages:send",
    {
      method: "POST",
      headers: {
        'Authorization': 'Bearer ' + helper.getAuth('firebase_cloud_messaging'),
        'Content-Type': 'application/json'
      },
      body:body
    }
  );
});

HTTPリクエストの外では、認証トークンはUUIDプレースホルダーに置き換えられます。例えば、次の宣言はHTTPリクエストの外で行われるため、プレースホルダーが返されます：

const token = helper.getAuth('firebase_cloud_messaging');

サポートされている認証タイプ

認証を追加する手順は、選択した認証によって異なります。次のセクションでは、Facebook、Google、APIキー、およびUID 2.0認証を追加するための指示を提供します。

OAauth 2.0認証の追加については、OAauth 2.0認証を追加するを参照してください。

Facebook認証

Facebook認証を追加する前に、Facebookにログインする必要があります。Facebook認証を追加するには、次の手順を使用します：

1. 機能を作成した後、詳細タブをクリックします。
2. Facebook広告アカウントにログインします。
3. 認証を割り当てるをクリックします。
4. +認証を追加をクリックし、Facebook認証を選択して続行をクリックします。
5. 名前を入力し、Facebookに接続をクリックします。
   認証トークンがユーザートークンで返されます。
6. 追加をクリックします。

Google認証

Google認証を追加するには、次の手順を使用します：

1. 機能を作成した後、詳細タブをクリックします。
2. 認証を割り当てるをクリックします。
3. +認証を追加をクリックし、Google認証を選択して続行をクリックします。
4. 名前と開発者トークンの名前を入力し、Googleに接続をクリックします。
   認証トークンがユーザートークンで返されます。
5. 追加をクリックします。

APIキー認証

APIキー認証を追加するには、次の手順を使用します：

1. 機能を作成した後、詳細タブをクリックします。
2. 認証を割り当てるをクリックします。
3. +認証を追加をクリックし、APIキーを選択して続行をクリックします。
4. トークンのための名前を入力し、次へをクリックします。
   指定された名前に基づいて機能のための一意のアクセストークン名が生成されます。
5. APIキーを入力します。保存して公開した後、APIキーは難読化され、表示されなくなります。
6. [オプション] ホワイトリストにホスト名を入力します。
7. 追加のホスト名をホワイトリストに追加するには、+ ホスト名を追加をクリックし、名前を入力します。
8. 追加をクリックします。
9. 完了をクリックします。

認証を削除する

機能またはコネクタに割り当てられた認証は削除できません。認証を削除するには、次の手順を使用します：

1. 詳細タブで、認証を割り当てるをクリックします。

2. 削除する認証のメニューで、削除をクリックします。
   認証が機能またはコネクタに割り当てられている場合、割り当てられている機能またはコネクタのリストが表示されるメッセージが表示されます。閉じるをクリックします。

   

   認証が機能またはコネクタに割り当てられていない場合、確認ダイアログが表示されます。削除をクリックします。