翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AppFabric GitHub用に を設定する
<a name="github"></a>

GitHubは、Git を使用してソフトウェア開発とバージョン管理を行うためのプラットフォームおよびクラウドベースのサービスで、開発者はコードを保存および管理できます。Git の分散型バージョン管理に加えて、アクセス制御、バグトラッキング、ソフトウェア機能要求、タスク管理、継続的インテグレーション、すべてのプロジェクトの Wiki を提供します。

 AWS AppFabric for security を使用すると、 から監査ログとユーザーデータを受信しGitHub、データを Open Cybersecurity Schema Framework (OCSF) 形式に正規化して、Amazon Simple Storage Service (Amazon S3) バケットまたは Amazon Data Firehose ストリームにデータを出力できます。

**Topics**
+ [GitHub での AppFabric のサポート](#github-appfabric-support)
+ [AppFabric を GitHub アカウントに接続する](#github-appfabric-connecting)

## GitHub での AppFabric のサポート
<a name="github-appfabric-support"></a>

AppFabric は、GitHub からのユーザー情報と監査ログの受信をサポートします。

### 前提条件
<a name="github-prerequisites"></a>

AppFabric を使用して GitHub からサポートされている宛先に監査ログを転送するには、以下の要件を満たす必要があります。
+ 監査ログにアクセスするには、エンタープライズアカウントが必要です。
+ エンタープライズ監査ログにアクセスするには、エンタープライズアカウントの管理者ロールが必要です。
+ 組織から監査ログを取得するには、組織のオーナーである必要があります。

### レート制限に関する考慮事項
<a name="github-rate-limits"></a>

GitHub は、GitHub API にレート制限を課します。GitHub API レート制限の詳細については、GitHubウェブサイトの「[API リクエストの制限と割り当て](https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/rate-limits-for-github-apps)」を参照してください。AppFabric と既存の GitHub API アプリケーションの組み合わせが GitHub’s の制限を超えると、AppFabric に監査ログが表示されるのが遅れる可能性があります。

### データ遅延に関する考慮事項
<a name="github-data-delay"></a>

監査イベントが取り込み先に転送されるまでに最大 30 分の遅延が発生する場合があります。これは、アプリケーションで利用できる監査イベントの遅延と、データ損失を減らすための予防措置によるものです。ただし、これはアカウントレベルでカスタマイズできる場合があります。サポートが必要な場合は、[サポート](https://aws.amazon.com/contact-us/) にお問い合わせください。

## AppFabric を GitHub アカウントに接続する
<a name="github-appfabric-connecting"></a>

AppFabric サービス内でアプリケーションバンドルを作成した後で、GitHubを使用して AppFabric を認可する必要があります。AppFabric GitHubで を認可するために必要な情報を確認するには、次の手順を実行します。

### OAuth アプリケーションの作成
<a name="github-create-oauth"></a>

AppFabric は OAuth を使用して GitHub と統合されます。GitHub で OAuth アプリケーションを作成するときは、以下の手順に従います。この詳細については、GitHub ウェブサイトの「[Creating GitHubs Apps](https://docs.github.com/en/apps/creating-github-apps)」を参照してください。

1. ページの右上にある [プロフィール写真] を選択し、**[設定]** を選択します。

1. 左側のナビゲーションペインの **[デベロッパー設定]** を選択します。

1. 左のナビゲーションペインから、**[OAuth アプリケーション]** を選択します。

1. **[新規 OAuth アプリケーション]** を選択します。
**注記**  
OAuth アプリをまだ作成していない場合、このボタンには **[新規アプリケーションの登録]** というラベルが表示されます。

1. **[アプリケーション名]** テキストボックスにアプリケーションの名前を入力します。

1. **[ホームページ URL]** テキストボックスに、アプリケーションインスタンスの完全な URL を入力します。

1. (オプション) **[アプリケーションの説明]** テキストボックスにアプリの説明を入力します。ユーザーにはこの説明が表示されます。

1. **[承認コールバック URL]** テキストボックスに、次の形式の URL を入力します。

   ```
   https://<region>.console.aws.amazon.com/appfabric/oauth2
   ```

   この URL で、*<リージョン>* iは、AppFabric アプリバンドルを構成した AWS リージョン のコードです。例えば、米国東部 (バージニア北部) リージョンのコードは `us-east-1` です。そのリージョンのリダイレクト URL は `https://us-east-1.console.aws.amazon.com/appfabric/oauth2` です。

1. OAuth アプリがデバイスフローを使用してユーザーの識別と承認を行う場合は、**[デバイスフローを有効にする]** を選択します。デバイスフローについて詳しくは、GitHub ウェブサイトの「[OAuth アプリの承認](https://docs.github.com/en/enterprise-cloud@latest/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps#device-flow)」を参照してください。

1. **[アプリケーションの登録]** を選択します。

### アプリ権限
<a name="github-app-authorizations"></a>

#### テナント ID
<a name="github-tenant-id"></a>

AppFabric はテナント ID を要求します。テナント ID は以下のいずれかの形式で指定する必要があります。

**エンタープライズ監査ログ:**

エンタープライズアカウントが所有するすべての組織のアクションを集約して知りたい場合は、エンタープライズの監査ログを使用してください。

エンタープライズ監査ログを使用するには、テナント ID がアカウントのエンタープライズ ID です。ブラウザのアドレスバーにエンタープライズ ID が表示されます。例えば、`exampleenterprise`は次のURL`https://github.com/settings/enterprises/examplenterprise`のエンタープライズIDです。

エンタープライズ監査ログのテナント ID を指定するときは、プレフィックスを付ける必要があります`enterprise:`。そのため、前の例ではと指定します`enterprise:examplenterprise`。

**組織監査ログ:**

組織のメンバーが実行したアクションを知りたい場合は、組織の監査ログを組織管理者として使用してください。アクションを実行したユーザー、アクション内容、実行日時などの詳細が含まれます。

組織の監査ログを使用するには、テナント ID が組織 ID です。ブラウザのアドレスバーに組織 ID が表示されます。例えば、`exampleorganization`は次のURL`https://github.com/settings/organizations/exampleorganization`の組織IDです。

組織監査ログのテナント ID を指定するときは、プレフィックスを付ける必要があります`organization:`。そのため、前の例では`organization:exampleorganization`と指定します。

#### テナント名
<a name="github-tenant-name"></a>

この固有のGitHubエンタープライズまたは組織を識別する名前を入力します。AppFabric は、テナント名を使用して、アプリ認可と、アプリ認可から作成されるすべての取り込みにラベルを付けます。

#### クライアント ID
<a name="github-client-id"></a>

AppFabric はクライアント ID を要求します。GitHubでクライアント ID を検索するには以下の手順を使用してください。

1. ページの右上にある [プロフィール写真] を選択し、**[設定]** を選択します。

1. 左側のナビゲーションペインの **[デベロッパー設定]** を選択します。

1. 左のナビゲーションペインから、**[OAuth アプリケーション]** を選択します。

1. 特定の OAuth アプリを選択し、**[クライアントID]** の値を探します。

#### クライアントシークレット
<a name="github-client-secret"></a>

AppFabric はクライアントシークレットを要求します。GitHub以下の手順でクライアントシークレット を検索してください。

1. ページの右上にある [プロフィール写真] を選択し、**[設定]** を選択します。

1. 左側のナビゲーションペインの **[デベロッパー設定]** を選択します。

1. 左のナビゲーションペインから、**[OAuth アプリケーション]** を選択します。

1. 特定の OAuth アプリを選択し、**[クライアントシークレット]** の値を探します。既存のクライアントシークレットが見つからない場合は、新しいクライアントシークレットを生成する必要がある場合があります。

#### 認可を承認します
<a name="github-approve-authorization"></a>

AppFabric でアプリ認可を作成すると、 から認可を承認GitHubするためのポップアップウィンドウが表示されます。AppFabric 認可を承認するには、**許可**を選択します。

[OAuthアプリ [へのアクセス制限が有効になっている場合は、組織が OAuth アプリケーションへのアクセスを許可していることを確認してください](https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data/approving-oauth-apps-for-your-organization)。](https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data/about-oauth-app-access-restrictions)