Appleサービス接続

概要

iOSコードの署名とデプロイを管理するために、APIキー認証またはAppleID認証のいずれかを使用してBitriseビルドをAppleサービスに接続します。

ワークフローには、App StoreConnectやAppleDeveloperPortalなどの使用するAppleサービスからの情報を必要とするステップが含まれている場合があります。これらの2つのサービスは、次の手順でサポートされています。

これらの手順を、ビルドがBitriseで実行されているときに使用するAppleサービスに接続するには、認証データをBitriseに提供し、アプリに確立された認証方法を選択する必要があります。

Appleの公式APIキーまたはAppleIDとパスワードを使用して認証できます。

Appleの2要素認証要件

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

これまでにAPIキーを使用して認証を行っている場合は、2要素認証の要件の影響を受けません。

ただし、Apple IDとパスワードを使用して認証を行っている場合は、新しい2FA要件影響を受ける場合は、AppleDeveloperアカウントを再接続する必要があります Appleサービス接続 Bitriseプロファイルのページ。また、2要素認証/ 2段階認証コードとアプリ固有のパスワードも提供する必要があります。アップルの公式ドキュメントをご覧ください。アプリ固有のパスワードを生成する方法。

AppleDeveloperアカウントに接続する必要がある手順

次の手順では、Appleサービス（App StoreConnectやAppleDeveloper Portalなど）に接続する必要があります。これらの手順のいずれかを使用している場合は、正しい方法で接続を確立していることを確認してください。

表1 Apple認証が必要な手順

ステップ	接続タイプ
iOSコード署名を管理する	API キー認証、Apple ID 認証、ステップ入力による API キー認証
iOS用のXcodeアーカイブとエクスポート	API キー認証、Apple ID 認証、ステップ入力による API キー認証
iOSおよびtvOSXcodeアーカイブをエクスポートする	API キー認証、Apple ID 認証、ステップ入力による API キー認証
iOS用のテスト用のXcodeビルド	API キー認証、Apple ID 認証、ステップ入力による API キー認証
fastlane	ステップ入力によるAPIキー認証、Apple ID認証、APIキーまたはAppleID認証
iTunesConnectにデプロイするステップ	ステップ入力によるAPIキー認証、Apple ID認証、APIキーまたはAppleID認証
App Store Connectへのデプロイ-アプリケーションローダー（以前のiTunes Connect）	ステップによるAPIキー認証、Apple ID認証、APIキーまたはAppleID認証

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

APIキー認証：可能であれば、この認証方法を使用することをお勧めします。二要素認証は必要ありません。必要なのは、提供することによってAppleサービスに接続することだけです名前、 発行者ID、 キーID アップロードします 秘密鍵（.p8）、次にアカウントを選択します チーム アプリの設定のタブ。指定したデータは、APIキー認証で機能するステップのそれぞれのフィールドに自動的に入力されます。
Apple ID認証：APIキー認証を使用できない場合は、AppleIDとパスワードで認証できます。あなたの Apple ID、 パスワード、 2FAコード と アプリ固有のパスワード 次に、の下のアカウントを選択します チーム アプリの設定のタブ。指定したデータは、AppleID認証で機能するステップのそれぞれのフィールドに自動的に入力されます。
ステップ入力による API キーまたは Apple ID 認証: 複数のチームにデプロイする場合、または認証が接続されているチームとは異なるチームにデプロイする場合は、好みの認証をステップの入力に追加できます。 Xcode Archive & Export for iOS などの一部のステップには、API キー認証オーバーライドオプションしかありませんが、fastlane などの一部のステップには、API キーと Apple ID の両方のステップレベル認証オーバーライドのオプションがあります。

Appleサービスの許可

概要

BitriseをAppleサービスに正常に接続するには、AppleIDとAPIキーに対してAppleアカウントで適切な役割とアクセスを設定する必要があります。

BitriseをAppleサービスに正常に接続するには、AppleIDとAPIキーに対してAppleアカウントで適切な役割とアクセスを設定する必要があります。次のことができるようにするには、適切なアクセス権を設定する必要があります。

自動コード署名を使用します。
アプリをAppStoreにデプロイします。

必要な正確な役割とアクセスは、認証方法、Xcodeマネージド署名を使用するかどうか、アプリの展開プロセスの詳細など、さまざまな要因によって異なります。

このガイドでは、2つの主要な役割に基づいて役割をリストします認証方法：APIキー認証とAppleID認証。

APIキー認証で必要なアクセス

Apple APIキー認証でビットライズステップを使用するには、適切なアクセスレベルでApp StoreConnectAPIキーを作成する必要があります。適切なレベルは、何をする必要があるかによって異なります。

たとえば、プロジェクトでXcodeマネージドサインインを使用していて、生成されたIPAファイルを配布証明書とApp Storeプロビジョニングプロファイルとともにエクスポートする場合、App StoreConnectAPIキーには次のものが必要です。管理者アクセス。

表1「APIキー認証を使用した自動コード署名に必要なアクセス」自動コード署名に必要なアクセスが含まれています。この表では、エクスポートしようとしているIPAファイルのタイプに基づいてコード署名アクションをグループ化しました。主に2つのタイプがあります。

開発IPA：これは発達方法。
配布IPA：これは app-store、このために、また企業配布方法。

表1 APIキー認証を使用した自動コード署名に必要なアクセス

コード署名アクション	Xcode管理署名をオンにした状態で必要なアクセス	Xcode管理署名がオフになっている場合に必要なアクセス
開発IPAのエクスポート。これには次のものが含まれます。開発プロビジョニングプロファイルの作成。開発プロビジョニングプロファイルを削除します。プロビジョニングプロファイルのダウンロード。アプリIDの登録と構成。デバイスUDIDの追加	デベロッパー	デベロッパー
AppStoreIPAのエクスポート。これには次のものが含まれます。開発および配布プロビジョニングプロファイルの作成。開発および配布プロビジョニングプロファイルの削除。プロビジョニングプロファイルのダウンロード。アプリIDの登録と構成。デバイスUDIDの追加	管理者	デベロッパー

表2「APIキー認証を使用したAppStoreの展開に必要なアクセス」アプリをAppStoreにデプロイするために必要な役割が含まれています。

App Storeの展開の場合、必要なアクセスは、生成されたIPAファイルをアップロードする方法によって異なります。次のいずれかを実行できます。

追加の手順なしでIPAのみをアップロードします。
メタデータとスクリーンショットを含むIPAをアップロードし、レビューのためにアプリを送信します。

表2 APIキー認証を使用したAppStoreの展開に必要なアクセス

AppStoreのデプロイアクション	APIキーに必要なアクセス
メタデータなしで新しいIPAをアップロードする	デベロッパー
新しいIPAのアップロードと：アプリのメタデータを更新しています。スクリーンショットをアップロードしています。 AppStoreレビューのためにアプリを送信します。	アプリマネージャー

AppleID認証で必要なアクセス

AppleID認証でBitriseStepsを使用するには、AppleIDがAppleDeveloperチームで適切な役割を果たしていることを確認する必要があります。

表1「AppleID認証を使用した自動コード署名に必要な役割」 Bitriseで自動コード署名を使用するために必要な役割が含まれています。この表では、エクスポートしようとしているIPAファイルのタイプに基づいてコード署名アクションをグループ化しました。主に2つのタイプがあります。

開発IPA：これは発達方法。
配布IPA：これは app-store、このために、また企業配布方法。

さまざまな配布方法の詳細をご覧ください。 Xcodeプロジェクト用に署名されたIPAを作成する。

Xcodeマネージド署名

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

表1 AppleID認証を使用した自動コード署名に必要な役割

コード署名アクション	必要な役割
開発IPAのエクスポート。これには次のものが含まれます。開発プロビジョニングプロファイルの作成。開発プロビジョニングプロファイルを削除します。プロビジョニングプロファイルのダウンロード。アプリIDの登録と構成。デバイスUDIDの追加	アプリマネージャー
AppStoreIPAのエクスポート。これには次のものが含まれます。開発および配布プロビジョニングプロファイルの作成。開発および配布プロビジョニングプロファイルの削除。プロビジョニングプロファイルのダウンロード。アプリIDの登録と構成。デバイスUDIDの追加	アプリマネージャー

表2「APIキー認証を使用したAppStoreの展開に必要な役割」アプリをAppStoreにデプロイするために必要な役割が含まれています。

App Storeの展開の場合、必要なアクセスは、生成されたIPAファイルをアップロードする方法によって異なります。次のいずれかを実行できます。

追加の手順なしでIPAのみをアップロードします。
メタデータとスクリーンショットを含むIPAをアップロードし、レビューのためにアプリを送信します。

表2 APIキー認証を使用したAppStoreの展開に必要な役割

AppStoreのデプロイアクション	AppleIDに必要な役割
メタデータなしで新しいIPAをアップロードする	デベロッパー
新しいIPAのアップロードと：アプリのメタデータを更新しています。スクリーンショットをアップロードしています。 AppStoreレビューのためにアプリを送信します。	アプリマネージャー

このセクションの内容:

参照:

アプリステップ手順アプリのワークフロー