メインコンテンツまでスキップ

SSHキーの設定

SSH キーは主な認証方法です。projectのリポジトリにアクセスするには、Bitrise に公開鍵と秘密鍵からなる SSH キーペアが必要です。公開鍵はプロジェクトの Git リポジトリに登録します。

これには1つ例外があります。Bitrise GitHub Appを使って Bitrise Workspaceを GitHub に接続する場合は、SSH キーは不要です。

HTTPS URLの使用

HTTPS Git URLを使用し、個人アクセストークンで認証することもできます。この場合、SSH キーは不要です。HTTPS の認証情報を設定する。

Bitrise にプロジェクトを最初に追加する際に SSH キーを追加できますが、キーはいつでも更新できます。プロジェクトを追加する際に SSH キーの設定をスキップし、後から SSH キーを登録することもできます。

複数のリポジトリへのアクセス

プロジェクトがビルド中に複数のリポジトリへアクセスする必要がある場合は、SSH キーペアを生成し、必要なすべてのリポジトリに公開鍵を登録することがベストプラクティスです。または、マシンユーザーを作成し、そのユーザーに SSH キーを登録することもできます。詳細については、サブモジュールまたはプライベートリポジトリ依存関係を持つアプリを参照してください。

独自の SSH キーペアを生成するClick to copy link​

自分のデバイスで独自の SSH キーペアを生成し、生成された公開鍵と秘密鍵を Bitrise の project で使用することもできます。これは完全に任意です。Bitrise にプロジェクトを追加する過程で、または後から Project settings メニューで、Bitrise が SSH キーを生成して自動的に登録できるためです。

コマンドライン/ターミナルの簡単なコマンドで、独自の SSH キーペアを生成します。

ssh-keygen -t rsa -b 4096 -P '' -f ./bitrise-ssh -m PEM

これにより、カレントディレクトリ(コマンドを実行したディレクトリ)に2つのファイルが生成されます。

  • bitrise-ssh(秘密鍵)
  • bitrise-ssh.pub(公開鍵)

公開鍵をコピーして、Git ホスティングサービス(例: GitHub)に貼り付けます。bitrise.io でプロジェクトを追加する際には、秘密鍵を入力する必要があります。

Bitrise project の SSH キーを設定するClick to copy link​

bitrise.io で SSH キーを設定するには、次の手順に従います。

  1. プロジェクトに対するAdminのロールを持つユーザー、またはEdit workflow権限を持つカスタムロールを持つユーザーで、Bitrise上のプロジェクトを開きます。

  2. プロジェクトのメインページで、Project settingsボタンをクリックします。

  3. 左側で Repository を選択します。

  4. Authorization セクションの Authorization method カードを見つけます。

  5. SSH キーの横にある Replace をクリックします。

    以前に SSH キーを追加したことがない場合、ボタンには代わりに Add SSH key と表示されます。

    SCR-20260401-pvvq.png

  6. 次の3つのオプションから選択します。

    Auto-add a generated SSH key to your repository: Bitrise が公開 SSH キーを GitHub リポジトリに自動的に登録します。リポジトリの管理者権限がある場合はこちらを選択してください。

    Copy a generated SSH key to your Git provider manually: Bitrise が SSH キーペアを生成します。公開鍵は Git リポジトリに手動で登録する必要があります。

    Add 独自の SSH key: 認証用に独自の SSH キーペアを用意し、公開鍵を Git リポジトリに手動で登録する必要があります。

  7. 自動追加オプションを選択した場合は Auto-add SSH key を、それ以外の2つのオプションの場合は Save changes をクリックします。

関連情報