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

Appleサービスへの接続について

Bitrise CIとRelease Managementは、どちらもAppleのオンラインサービスを必要とするMobile DevOpsプロセスの自動化に役立ちます。Apple Developer PortalやApp Store Connectなどのこれらのサービスに接続するには、Bitriseに認証データを提供し、プロジェクトに合わせて確立された認証方法を選択する必要があります。

Appleの公式APIキー、またはApple IDとパスワードで認証できます。

Appleの二要素認証要件Click to copy link​

Appleの二要素認証(2FA)は、Appleアカウントに追加のセキュリティレイヤーを提供します。

これまでAPIキーで認証していた場合、この二要素認証の要件による影響はありません。

ただし、Apple IDとパスワードで認証しており、新しい2FAの要件の対象となる場合は、BitriseプロファイルのConnected accountsページでApple Developer Accountを再接続する必要があります。また、二要素認証(二段階認証)コードとapp-specific passwordの入力も必要です。app-specific passwordの生成方法については、公式のAppleドキュメントを参照してください。

Apple Developer accountへの接続が必要なStepsClick to copy link​

以下のStepsは、Appleサービス(App Store ConnectやApple Developer Portalなど)への接続が必要です。これらのStepsのいずれかを使用している場合は、適切な方法で接続を確立してください。

StepsConnection type
Manage iOS Code SigningAPIキー認証、Apple ID認証、Step inputs経由のAPIキー認証
Xcode Archive & Export for iOSAPIキー認証、Apple ID認証、Step inputs経由のAPIキー認証
iOSおよびtvOSのXcode archiveのエクスポートAPIキー認証、Apple ID認証、Step inputs経由のAPIキー認証
Xcode Build for testing for iOSAPIキー認証、Apple ID認証、Step inputs経由のAPIキー認証
fastlaneAPIキー認証、Apple ID認証、Step inputs経由のAPIキーまたはApple ID認証
Deliverを使用したDeploy to App Store Connect(旧iTunes Connect)APIキー認証、Apple ID認証、Step inputs経由のAPIキーまたはApple ID認証
Deploy to App Store Connect - Application Loader(旧iTunes Connect)APIキー認証、Apple ID認証、Step経由のAPIキーまたはApple ID認証

プロジェクトで使用できる認証方法に応じて、以下のオプションがあります。

  • API key認証: 可能であれば、この認証方法の使用をお勧めします。二要素認証は不要です。Name、Issuer ID、Key IDを入力し、Private Key (.p8)をアップロードしてから、アプリの設定のStoresタブでアカウントを選択するだけで、Appleサービスに接続できます。入力したデータは、APIキー認証で動作するStepsの該当フィールドに自動的に反映されます。
  • Apple ID authentication: APIキー認証を使用できない場合は、Apple IDとパスワードで認証できます。Apple ID、パスワード、2FA code、app-specific passwordを入力し、アプリの設定のStoresタブでselect an accountします。入力したデータは、Apple ID認証で動作するStepsの該当フィールドに自動的に反映されます。
  • Step inputs経由のAPI keyまたはApple Id認証: 複数のチームにデプロイしたい場合や、これまで接続していた認証とは異なる認証のチームにデプロイしたい場合は、任意の認証情報をStepの入力項目に追加できます。Xcode Archive & Export for iOSのようにAPIキー認証の上書きオプションしかないStepsもあれば、fastlaneのようにAPIキーとApple ID Stepレベルの認証の両方を上書きできるオプションを持つStepsもあります。

Appleサービスの権限Click to copy link​

BitriseをAppleサービスに正しく接続するには、AppleアカウントでApple IDおよびAPIキーに適切なロールとアクセス権を設定する必要があります。次のことを行うには、適切なアクセス権を設定する必要があります。

  • automatic code signingを使用する。
  • アプリをApp Storeにデプロイする。

必要な正確なロールとアクセス権は、認証方法、Xcode管理署名を使用するかどうか、アプリのデプロイプロセスの詳細など、複数の要因によって異なります。

このガイドでは、2つの主な認証方法、APIキー認証とApple ID認証をもとにロールを紹介します。

APIキー認証で必要なアクセス権Click to copy link​

Apple APIキー認証でBitrise Stepsを使用するには、適切なアクセスレベルを持つApp Store Connect APIキーを作成する必要があります。適切なレベルは、行う必要のある作業によって異なります。

たとえば、プロジェクトでXcode管理署名を使用し、生成されたIPAファイルをDistribution証明書とApp Storeプロビジョニングプロファイルでエクスポートしたい場合、App Store Connect APIキーにはAdminアクセス権が必要です。

次の表は、automatic code signingに必要なアクセス権を示しています。この表では、エクスポートしようとするIPAファイルの種類に基づいてcode signingのアクションをグループ化しています。主な種類は2つあります。

  • Development IPA: developmentメソッドでエクスポートされたIPAです。
  • Distribution IPA: app-store、ad-hoc、またはenterprisedistribution methodでエクスポートされたIPAです。
Code signingアクションXcode管理署名がONの場合に必要なアクセス権Xcode管理署名がOFFの場合に必要なアクセス権
Development IPAのエクスポート。以下が含まれます。 - 開発用プロビジョニングプロファイルの作成。 - 開発用プロビジョニングプロファイルの削除。 - プロビジョニングプロファイルのダウンロード。 - App IDの登録と設定。 - デバイスUDIDの追加DeveloperDeveloper
App Store IPAのエクスポート。以下が含まれます。 - 開発用および配布用プロビジョニングプロファイルの作成。 - 開発用および配布用プロビジョニングプロファイルの削除。 - プロビジョニングプロファイルのダウンロード。 - App IDの登録と設定。 - デバイスUDIDの追加AdminDeveloper

次の表は、アプリをApp Storeにデプロイするために必要なロールを示しています。

App Storeへのデプロイでは、生成されたIPAファイルをどのようにアップロードするかによって必要なアクセス権が異なります。次のいずれかを行えます。

  • 追加の手順なしでIPAのみをアップロードする。
  • メタデータとスクリーンショットを含めてIPAをアップロードし、アプリを審査に提出する。
App StoreデプロイのアクションAPIキーに必要なアクセス権
メタデータなしで新しいIPAをアップロードDeveloper
新しいIPAをアップロードし、以下を行う場合: - アプリのメタデータの更新。 - スクリーンショットのアップロード。 - App Store審査へのアプリの提出。App Manager

Apple ID認証で必要なアクセス権Click to copy link​

Apple ID認証でBitrise Stepsを使用するには、Apple IDがApple Developerチームで適切なロールを持っていることを確認する必要があります。

次の表は、Bitriseでautomatic code signingを使用するために必要なロールを示しています。この表では、エクスポートしようとするIPAファイルの種類に基づいてcode signingのアクションをグループ化しています。主な種類は2つあります。

  • Development IPA: developmentメソッドでエクスポートされたIPAです。
  • Distribution IPA: app-store、ad-hoc、またはenterprisedistribution methodでエクスポートされたIPAです。

さまざまなdistribution methodの詳細については、Xcodeプロジェクト用の署名済みIPAの作成を参照してください。

Xcodeの管理署名

BitriseでApple ID認証を使用する場合、プロジェクトのXcode管理署名は自動的にオフになります。代わりに、Bitriseは独自のautomatic code signingロジックを使用します。

Code signingアクション必要なロール
development IPAのエクスポート。以下が含まれます。 - 開発用プロビジョニングプロファイルの作成。 - 開発用プロビジョニングプロファイルの削除。 - プロビジョニングプロファイルのダウンロード。 - App IDの登録と設定。 - デバイスUDIDの追加App Manager
App Store IPAのエクスポート。以下が含まれます。 - 開発用および配布用プロビジョニングプロファイルの作成。 - 開発用および配布用プロビジョニングプロファイルの削除。 - プロビジョニングプロファイルのダウンロード。 - App IDの登録と設定。 - デバイスUDIDの追加App Manager

次の表は、アプリをApp Storeにデプロイするために必要なロールを示しています。

App Storeへのデプロイでは、生成されたIPAファイルをどのようにアップロードするかによって必要なアクセス権が異なります。次のいずれかを行えます。

  • 追加の手順なしでIPAのみをアップロードする。
  • メタデータとスクリーンショットを含めてIPAをアップロードし、アプリを審査に提出する。
App StoreデプロイのアクションApple IDに必要なロール
メタデータなしで新しいIPAをアップロードDeveloper
新しいIPAをアップロードし、以下を行う場合: - アプリのメタデータの更新。 - スクリーンショットのアップロード。 - App Store審査へのアプリの提出。App Manager