- Bitriseドキュメントへようこそ!
- API
- iOSコード署名ファイルの管理
iOSコード署名ファイルの管理
You can upload, update, list, and delete iOS code signing files with the Bitrise API: we have separate endpoints for certificates and provisioning profiles.
このガイドでは、BitriseAPIを使用してiOSコード署名ファイルを管理する方法について説明します。 UIで同じことを行う方法について詳しく知りたい場合は、チェックアウトしてください。 iOSコード署名
APIを使用して、iOSコード署名ファイルをアップロード、更新、一覧表示、および削除できます。このガイドでは、これらのコード署名エンドポイントをどのように、どのような順序で使用するかを示します。
エンドポイント |
関数 |
アプリのチームで必要な役割 |
---|---|---|
プロビジョニングファイルを作成する |
所有者または管理者 |
|
POST / apps / {app-slug} / Provisioning-profiles / {provisioning-profile-slug} / uploaded |
アップロードプロセスを確認します |
所有者または管理者 |
PATCH / apps / {app-slug} / Provisioning-profiles / {provisioning-profile-slug} |
アップロードされたプロビジョニングファイルを更新します |
所有者または管理者 |
アップロードされたプロビジョニングファイルのリストを取得します |
所有者または管理者 |
|
GET / apps / {app-slug} / Provisioning-profiles / {provisioning-profile-slug} |
特定のプロビジョニングファイルのデータを取得する |
所有者または管理者 |
DELETE / apps / {app-slug} / Provisioning-profiles / {provisioning-profile-slug} |
アップロードされたプロビジョニングファイルを削除します |
所有者または管理者 |
エンドポイント |
関数 |
アプリのチームで必要な役割 |
---|---|---|
ビルド証明書を作成する |
所有者または管理者 |
|
POST / apps / {app-slug} / build-certificates / {build-certificate-slug} / uploaded |
アップロードプロセスを確認します |
所有者または管理者 |
PATCH / apps / {app-slug} / build-certificates / {build-certificate-slug} |
アップロードされたビルド証明書を更新します |
所有者または管理者 |
アップロードされたビルド証明書のリストを取得します |
所有者または管理者 |
|
GET / apps / {app-slug} / build-certificates / {build-certificate-slug} |
特定のビルド証明書のデータを取得する |
所有者または管理者 |
DELETE / apps / {app-slug} / build-certificates / {build-certificate-slug} |
アップロードしたビルド証明書を削除する |
所有者または管理者 |
iOSコード署名ファイルの作成とアップロード
必要な役割
Bitrise APIを使用してiOSコード署名ファイルを管理するには、アプリのチームで管理者または所有者の役割が必要です。
ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。 アプリチームでのユーザーの役割。
選択したBitriseアプリに新しいiOSコード署名ファイルを追加できます。次のことを行う必要があります。
-
のPOSTメソッドを呼び出します
provisioning-profiles
またbuild-certificates
エンドポイントupload_file_name
とupload_file_size
パラメーター。NS
upload_file_name
パラメータは、既存のプロビジョニングプロファイルへのパスを指定する必要があります。この呼び出しにより、事前に署名された一時的なアップロードURLが作成されます。 -
を使用してファイルをAWSにアップロードします
upload_url
応答からのパラメータ。 -
のPOST呼び出しでファイルのアップロードを確認します
uploaded
終点。これにより、
processed
ファイルのフラグをtrue
。このフラグは後で変更することはできません。
ファイルの作成:
curl -X POST -H 'Authorization: THE-ACCESS-TOKEN' 'https://api.bitrise.io/v0.1/apps/APP-SLUG/provisioning-profiles' -d '{"upload_file_name":"sample.provisionprofile","upload_file_size":2047}'
応答:
{ "data":{ "upload_file_name":"sample.provisionprofile", "upload_file_size":2047, "slug":"01C6FA6P6HRQT5PQ8RMMVVXE6W", "processed":false, "is_expose":true, "is_protected":false, "upload_url":"https://concrete-userfiles-production.s3-us-west-2.amazonaws.com/build_certificates/uploads/30067/original/certs.p12?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIOC7N256G7J2W2TQ%2F20180216%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180216T124240Z&X-Amz-Expires=600&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Signature=2bf42176650f00405abfd7b7757635c9be16b43e98013abb7f750d3c658be28e" } }
ファイル名、そのサイズ、スラッグ、および事前に署名されたアップロードURLが取得されます(変更可能ないくつかの属性とともに)。この事前署名されたアップロードURLは、iOSコード署名ファイルを宛先にアップロードするために使用する一時的なリンクです。
の値を使用してファイルをAWSにアップロードする upload_url
パラメータ:
curl -T sample.provisionprofile 'https://concrete-userfiles-production.s3-us-west-2.amazonaws.com/build_certificates/uploads/30067/original/certs.p12?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIOC7N256G7J2W2TQ%2F20180216%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180216T124240Z&X-Amz-Expires=600&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Signature=2bf42176650f00405abfd7b7757635c9be16b43e98013abb7f750d3c658be28e'
アップロードの確認:
curl -X POST -H 'Authorization: THE-ACCESS-TOKEN' 'https://api.bitrise.io/v0.1/apps/APP-SLUG/provisioning-profiles/PROVISIONING-PROFILE-SLUG/uploaded'
アップロードされたiOSコード署名ファイルの更新
アップロードされたiOSコード署名ファイルにマイナーアップデートを実行するには、 PATCH
方法。ファイルをにアップロードした場合 ビットライズ、で変更を視覚的に確認できます コード署名 タブ。
必要な役割
Bitrise APIを使用してiOSコード署名ファイルを管理するには、アプリのチームで管理者または所有者の役割が必要です。
ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。 アプリチームでのユーザーの役割。
たとえば、 プロビジョニングプロファイル 保護された、あなたは設定することができます is_protected
プロビジョニングプロファイルのフラグ true
。
curl -X PATCH -H 'Authorization: THE-ACCESS-TOKEN' 'https://api.bitrise.io/v0.1/apps/APP-SLUG/provisioning-profiles/PROVISIONING-PROFILE-SLUG -d '{"is_protected":true}'
のために 証明書を作成する 上記と同じ属性を設定できますが、パスワードを変更することもできます。
curl -X PATCH -H 'Authorization: THE-ACCESS-TOKEN' 'https://api.bitrise.io/v0.1/apps/APP-SLUG/build-certificates/BUILD-CERTIFICATE-SLUG -d '{"certificate_password":"s0m3-v3ry-s3cr3t-str1ng"}'
属性を設定するときは注意してください
あなたは設定することができます is_protected
、 is_exposed
と processed
アップロードしたファイルの属性:
-
一度
is_protected
フラグはに設定されますtrue,
もう変更することはできません。 -
の値が
is_protected
本当なら、is_expose
フラグを別の値に設定することはできません。 -
一度
processed
フラグがtrueに設定されると、その値は変更できなくなります。
特定のiOSコード署名ファイルのデータを取得する
必要な役割
Bitrise APIを使用してiOSコード署名ファイルを管理するには、アプリのチームで管理者または所有者の役割が必要です。
ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。 アプリチームでのユーザーの役割。
のGETメソッドを使用して特定のiOSコード署名ファイルのデータを取得します provisioning-profiles
と build-certificates
エンドポイント。返されるデータには、特に、ファイルの名前、サイズ、ダウンロードURL、および現在のステータスが含まれます。
必要なパラメーターは次のとおりです。
-
アプリスラッグ
-
ファイルスラッグ
リクエスト:
curl -X GET -H 'Authorization: THE-ACCESS-TOKEN' 'https://api.bitrise.io/v0.1/apps/APP-SLUG/provisioning-profiles/PROVISIONING-PROFILE-SLUG'
応答:
{ "data": { "upload_file_name":"sample.provisionprofile", "upload_file_size":2047, "slug":"01C6FA6P6HRQT5PQ8RMMVVXE6W", "processed":false, "is_expose":true, "is_protected":false, "download_url":"https://concrete-userfiles-production.s3-us-west-2.amazonaws.com/prov_profile_documents/uploads/80144/original/sample.provisionprofile?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIOC7N256G7J2W2TQ%2F20180322%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180322T091652Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=6dd7bb3db72aafb2d434da7b1a8f80a82a3a7a0276e84620137ed64de5025ab2" } }
の可用性 download_url
注意してください download_url
プロビジョニングプロファイルが is_protected
属性がfalseです。
アプリのiOSコード署名ファイルの一覧表示
必要な役割
Bitrise APIを使用してiOSコード署名ファイルを管理するには、アプリのチームで管理者または所有者の役割が必要です。
ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。 アプリチームでのユーザーの役割。
アプリに属するiOSコード署名ファイルの数を知りたいですか?を使用してそれらのリストを取得します GET
の方法 provisioning-profiles
と build-certificates
エンドポイント。
必要なパラメーターは次のとおりです。
-
アプリスラッグ
オプションのパラメータは次のとおりです。
-
次へ:応答の最初のファイルのスラッグ(文字列として)
-
制限:ページあたりの要素の最大数(整数)。デフォルトは50です。
リクエスト:
curl -X GET -H 'Authorization: THE-ACCESS-TOKEN' 'https://api.bitrise.io/v0.1/apps/APP-SLUG/provisioning-profiles'
応答:
{ "data": [ { "upload_file_name":"sample.provisionprofile", "upload_file_size":2047, "slug":"01C6FA6P6HRQT5PQ8RMMVVXE6W", "processed":false, "is_expose":true, "is_protected":false }, { "upload_file_name":"sample2.provisionprofile", "upload_file_size":2047, "slug":"01C6FA6P6HRQT5PQ8RMMVVXE5T", "processed":true, "is_expose":true, "is_protected":true } ], "paging": { "page_item_limit": 50, "total_item_count": 2 } }