長期トークンなしでデプロイできるよう、Zinn® GitHub アプリをインストールしてください

接続によるメリット

Zinn® GitHub アプリをインストールすると、個人用トークンを当社に渡すことなく、お客様のリポジトリからサイトをデプロイし、プロジェクトボードを GitHub と同期させることができます。当社が保持するのはアプリのインストール番号のみであり、これ単体では機能せず、必要になるたびに1時間有効なトークンを発行します。組織にとってこれはより適切な選択肢です。特定の一人の個人に属することがなく、誰かが退職しても動作が停止することがないためです。

開始する前に

GitHub アカウント、またはアプリをインストールする組織のオーナー権限が必要です。サードパーティ製アプリを禁止している組織では、オーナーによる許可が必要です。それが不可能な場合は、代わりにファイングレイントークン (GitHub アカウントを接続) をご利用ください。

1. GitHub でキーを作成する

作成すべきキーはありません。個人アカウントまたは組織に Zinn® GitHub アプリをインストールし、すべてのリポジトリ、または当社にデプロイを許可するリポジトリのみのいずれかを選択してください。

次に、インストール番号を確認します:

• 個人アカウント — Settings → Applications → Installed GitHub Apps に進み、Zinn® アプリの横にある Configure を選択します。
• 組織 — Your organizations → Settings → GitHub Apps に進み、Zinn® アプリの横にある Configure を選択します。

そのページのアドレスバーの末尾にある番号 (例: github.com/settings/installations/12345678) がインストール番号です。

2. ここで接続する

アプリは「連携」画面ではなく、実際に使用する場所で選択します:

• サイトのリポジトリ接続時は、GitHub (app install) を選択してください。
• プロジェクトボードの GitHub 連携時は、Zinn® GitHub アプリ を選択してください。

インストール番号を貼り付けて続行してください。何かを保存する前にインストール状況を確認します。到達できない番号が保存されることはありません。

次に行われること

• アプリに権限を付与したリポジトリがサイトのデプロイ元として表示され、プッシュによってデプロイが実行されます。
• 当社が実行するすべてのアクションは、お客様の名前ではなくアプリの名前で、GitHub 上のインストールの監査ログに記録されます。
• 追加のリポジトリへのアクセスを許可する場合は、同じ Configure ページでアプリのリポジトリへのアクセス権を変更してください。再接続の必要はありません。

接続できない場合

リポジトリが見つかりません。 インストールはお客様が選択したリポジトリのみを対象としています。Configure を開いて追加してください。

番号が拒否されます。 アプリ自体の ID ではなくアドレスバーのインストール番号であること、およびアプリがまだインストールされていることをご確認ください。アンインストールされたアプリにはインストール情報が存在しません。

キーが拒否されたと表示されます。 ほとんどの場合、スペースや改行が一緒にコピーされた、キーの有効期限が切れている、またはコピー後にキーが失効・再生成されたという3つの原因のいずれかです。新しく作成して、再度貼り付けてください。

接続はできましたが、その後の処理が失敗します。 キーは認証されていますが、アクションに必要な権限が不足しています。上記に記載されている権限を持つ新しいキーを作成し、古い接続を切断した上で新しいキーを接続してください。

切断

連携を開き、アカウントを見つけて切断を押してください。これにより、保存されていたキーは直ちに削除されます。それを使用していたものはすべて次のアクションで停止し、それに依存していた画面は警告なしに失敗するのではなく、その旨を表示します。

切断しても、すでに完了した処理が元に戻ることはありません。お客様のアカウントで当社が変更したレコード、デプロイ、設定はそのまま残ります。キー自体が漏洩した可能性があると思われる場合は、ベンダー側でも失効させてください。切断によって削除されるのは当社のコピーのみであり、ベンダー側のコピーではありません。