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

# 接続はどのように機能しますか？
<a name="welcome-connections-how-it-works"></a>

接続を作成する前に、サードパーティーアカウントで AWS 認証アプリケーションをインストールするか、そのアプリケーションへのアクセス権を提供する必要があります。接続をインストールした後、このインストールを使用するように更新できます。接続を作成すると、サードパーティーアカウントの AWS リソースへのアクセスを許可します。これにより、 接続は、 AWS リソースに代わって、サードパーティーアカウントのソースリポジトリなどのコンテンツにアクセスできます。その後、その接続を他の と共有 AWS のサービス して、リソース間で安全な OAuth 接続を提供できます。

クラウドベースの接続は次のように設定されていますが、ユーザーアカウントまたは組織間では違いがあります。
+ **ユーザーアカウント:** 各クラウドベースのサードパーティーユーザーアカウントには、コネクタアプリがインストールされています。複数の接続をアプリケーションのインストールに関連付けることができます。
+ **Organizations:** 各クラウドベースのサードパーティー組織には、コネクタアプリがインストールされています。組織内の接続の場合、組織内の各組織アカウントへの接続マッピングは 1:1 です。複数の接続をアプリケーションのインストールに関連付けることはできません。組織が接続を操作する方法の詳細については、「」を参照してください[AWS CodeConnections の接続が組織と連携する方法](welcome-connections-how-it-works-github-organizations.md)。

次の図は、クラウドベースの接続がユーザーアカウントまたは組織とどのように連携するかを示しています。

![アプリのインストールとクラウドベースのプロバイダーの接続の関係を示す図。](http://docs.aws.amazon.com/ja_jp/dtconsole/latest/userguide/images/connections-flow.png)


接続は、それらを作成する AWS アカウント によって所有されます。接続は、接続 ID を含む ARN によって識別されます。接続 ID は、変更または再マッピングできない UUID です。接続を削除して再確立すると、新しい接続 ID が作成されるため、新しい接続 ARN が作成されます。つまり、接続 ARN が再利用されることはありません。

新しく作成された接続が `Pending` 状態です。接続のセットアップを完了し、接続を `Pending` 状態から `Available` 状態に移行するには、サードパーティーのハンドシェイク（OAuthフロー）プロセスが必要です。これが完了すると、接続は `Available`になり、CodePipeline などの AWS サービスで使用できます。

GitHub Enterprise Server や GitLabセルフマネージドなどのインストール済みプロバイダータイプ (オンプレミス) への接続を作成する場合は、接続にホストリソースを使用します。

オンプレミス接続は次のように設定されていますが、ユーザーアカウントまたは組織間では違いがあります。
+ **ユーザーアカウント:** 各オンプレミスのサードパーティーユーザーアカウントには、コネクタアプリがインストールされています。オンプレミスプロバイダーの複数の接続を 1 つのホストに関連付けることができます。
+ **Organizations:** 各オンプレミスのサードパーティー組織には、コネクタアプリがインストールされています。GitHub Organizations for GitHub Enterprise Server などの組織内のオンプレミス接続の場合、組織内の接続ごとに新しいホストを作成し、ホストのネットワークフィールド (VPC、サブネット IDs、セキュリティグループ IDs) に同じ情報を入力します。組織が接続を操作する方法の詳細については、「」を参照してください[AWS CodeConnections の接続が組織と連携する方法](welcome-connections-how-it-works-github-organizations.md)。
+ **すべて: **オンプレミス接続ごとに、各 VPC は一度に 1 つのホストにのみ関連付けることができます。

いずれの場合も、オンプレミスサーバーの URL を指定する必要があります。さらに、サーバーがプライベート VPC 内にある (インターネット経由でアクセスできない) 場合は、オプションの TLS 証明書情報とともに VPC 情報を提供する必要があります。これらの設定により、CodeConnections はインスタンスと通信でき、このホスト用に作成されたすべての接続で共有されます。たとえば、単一の GitHub Enterprise Server インスタンスの場合、ホストで表される単一のアプリケーションを作成します。次に、ユーザーアカウント設定では、次の図に示すように、アプリのインストールに対応する、そのホストに複数の接続を作成できます。それ以外の場合は、組織に対して、そのホストの単一のアプリケーションインストールと接続を作成します。

次の図は、オンプレミス接続がユーザーアカウントまたは組織とどのように連携するかを示しています。

![アプリのインストールとオンプレミスプロバイダーの接続の関係を示す図。](http://docs.aws.amazon.com/ja_jp/dtconsole/latest/userguide/images/connections-flow-host.png)


新しく作成されたホストは `Pending` 状態です。ホストのセットアップを完了し、ホストを `Pending` 状態から `Available` 状態に移行するには、サードパーティーの登録プロセスが必要です。これが完了すると、ホストは `Available` で、インストール済プロバイダータイプへの接続に使用できます。

接続ワークフローの概要については、「[接続を作成または更新するワークフロー](welcome-connections-workflow.md)」を参照してください。インストール済みプロバイダー用のホスト作成ワークフローの概要については、「[ホストを作成または更新するワークフロー](welcome-hosts-workflow.md)」を参照してください。プロバイダーのタイプ別に接続を作成するハイレベルの手順については、「[接続の使用](connections.md)」を参照してください。