Skip to main content

サードパーティアプリケーションと接続する

GitHub の ID を、OAuth を使ってサード パーティのアプリケーションに接続できます。 これらのアプリケーションを認可する際には、そのアプリケーションを信頼するか、誰が開発したのか、そのアプリケーションがどういった種類の情報にアクセスしたいのかを確認すべきです。

サード パーティのアプリケーションがユーザーの GitHub ログインでユーザーを識別する必要がある場合、開発者の連絡先情報と、要求されている特定のデータの一覧を含むページが表示されます。

アプリケーション開発者に連絡する

アプリケーションは GitHub ではないサード パーティによって開発されているため、アクセスを求められているデータがアプリケーションでどのように使われるのか、こちら側では正確にはわかりません。 アプリケーションについて質問や懸念事項がある場合は、アプリケーション開発者にお問い合わせください。 アプリケーションの連絡先情報を見つけるには、アプリの承認ページの上部にある開発者のアカウント名をクリックします。

開発者が詳細情報を入力している場合は、承認ページの右側に、アプリケーションの詳細情報や関連する Web サイトも表示されます。

アプリケーションのアクセスとデータのタイプ

アプリケーションは、GitHub のデータに対して "読み取り" または "書き込み" アクセス権を持っている可能性があります。____

  • 読み取りアクセスでは、アプリケーションはデータの "閲覧" のみ可能です。
  • 書き込みアクセスでは、アプリケーションはデータの "変更" が可能です。

OAuth のスコープについて

_スコープ_は、アプリケーションがパブリックおよび非パブリックのデータへのアクセスを要求する権限の名前付きのグループです。

GitHub と統合するサード パーティ アプリケーションを使いたいときは、そのアプリケーションによって、データに対して必要なアクセスの種類がユーザーに通知されます。 アプリケーションにアクセスを許可すれば、アプリケーションはあなたの代わりにデータの読み取りや変更といったアクションを行えるようになります。 たとえば、user:email スコープを要求するアプリを使用する必要がある場合、アプリは個人用メール アドレスへの読み取り専用アクセス権を持つことになります。 詳しくは、「OAuth アプリのスコープ」をご覧ください。

Note

現在、ソース コードのアクセスのスコープを読み取り専用に設定することはできません。

Tip

認可されたインテグレーションを定期的にレビューすることをおすすめします。 しばらくの間使われていないアプリケーションやトークンは削除してください。 詳しくは、「承認された OAuth アプリをレビューする」をご覧ください。

リクエストされるデータの種類

アプリケーションがリクエストできるデータの種類はいくつかあります。

データの種類説明
コミットのステータスサードパーティアプリケーションに、コミットのステータスを報告するためのアクセスを許可できます。 コミットステータスのアクセスがあれば、アプリケーションはビルドが特定のコミットに対して成功したかどうかを判定できます。 アプリケーションはコードへはアクセスできませんが、特定のコミットに対するステータス情報を読み書きすることはできます
デプロイメントデプロイメントステータスにアクセスできれば、アプリケーションは、リポジトリの特定のコミットに対してデプロイメントが成功したかどうかを判断できます。 アプリケーションはコードにアクセスできなくなります。
GistsGist アクセスでは、ユーザーのパブリック Gist とシークレット Gist の両方への、アプリケーションによる読み取りや書き込みが可能です。
フックアプリケーションは、Webhook アクセスで、管理するリポジトリのフック構成の読み取りや書き込みができるようになります。
通知通知アクセス権があれば、アプリケーションは issue や pull request へのコメントなど、ユーザーの GitHub 通知を読むことができます。 ただし、アプリケーションはリポジトリ内へはアクセスできません。
組織とチームOrganization および Team のアクセスがあれば、アプリケーションは Organization および Team のメンバー構成へのアクセスと管理ができます。
ユーザーの個人データユーザデータには、名前、メールアドレス、所在地など、ユーザプロファイル内の情報が含まれます。
リポジトリリポジトリ情報には、コントリビュータの名前、あなたが作成したブランチ、リポジトリ内の実際のファイルなどが含まれます。 アプリケーションは、可視可能な全レベルのすべてのリポジトリへのアクセスを要求できます。 詳しくは、「リポジトリについて」をご覧ください。
リポジトリの削除アプリケーションはあなたが管理するリポジトリの削除をリクエストできますが、コードにアクセスすることはできません。