プライベート拡張機能パッケージの共有
develop_extensions
権限を持つユーザーは、その拡張機能パッケージの拡張機能パッケージ使用権限を作成、リストおよび削除できます。 manage_properties
権限を持つ承認済み組織内のユーザーは、組織での拡張機能パッケージの使用権限をリストし、その拡張機能パッケージを使用する場合は accepted
に、使用しない場合は rejected
に、状態を更新することのみが許可されます。拡張機能パッケージの所有者は、Reactor API を通じて、他社の非公開バージョンを利用する権限を付与できます。 1 つの拡張機能パッケージの使用ライセンスが承認された各ビジネスに付与され、この承認は、パッケージの現在および将来のプライベートバージョンすべてに適しています。
このガイドでは、拡張機能パッケージの使用権限を設定する方法の概要を説明します。 認証の構造の JSON の例など、Reactor API で認証を管理する方法に関するガイダンスについて詳しくは、 拡張機能パッケージ使用承認エンドポイントガイドを参照してください。
認証の作成 create-authorization
新しい認証を作成するには、develop_extensions
権限が必要です。 次の例は、認証する会社の authorized_org_id
を使用して、拡張機能パッケージの拡張機能パッケージの使用状況認証を作成する方法を示しています。
API 形式
POST /extension_packages/{EXTENSION_PACKAGE_ID}/extension_package_usage_authorizations
EXTENSION_PACKAGE_ID
ID
。リクエスト
次のリクエストは、指定された会社の新しい拡張機能パッケージ認証を作成します。
curl -X POST \
https://reactor.adobe.io/extension_packages/{EXTENSION_PACKAGE_ID}/extension_package_usage_authorizations \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H "Content-Type: application/vnd.api+json" \
-d '{
"data": {
"attributes": {
"authorized_org_id": "{ORG_ID}"
},
"type": "extension_package_usage_authorizations"
}
}
attributes.authorized_org_id
ID
。認証の初期状態は pending_approval
の段階です。 会社は、拡張機能パッケージを使用する前に、認証を承認する必要があります。 会社のユーザーは、認証が承認保留中の間はプライベート拡張機能パッケージを参照できますが、インストールできず、拡張機能カタログに見つかりません。
承認を承認 approve-authorization
承認を承認するには、manage_properties
の権限が必要です。 認証済み会社として、拡張機能パッケージの使用認証に、認証の ID
を含むPATCHリクエストを送信し、state を approved
に設定する必要があります。
API 形式
PATCH //extension_package_usage_authorizations/{EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID}
EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID
ID
。リクエスト
次のPATCHリクエストは、認証の state
を approved
に設定します。
curl -X PATCH \
https://reactor.adobe.io/extension_package_usage_authorizations/{EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID} \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-Api-Key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H "Content-Type: application/vnd.api+json" \
-d '{
"data": {
"attributes": {
"state": "approved"
},
"id": ":extension_package_usage_authorization_id",
"type": "extension_package_usage_authorizations"
}
}
認証が承認されると、認証済み会社として、プロパティに拡張機能パッケージをインストールできるようになります。
認証の削除 delete-authorization
拡張機能パッケージの所有者は、拡張機能パッケージの使用認証を削除することで、いつでも認証を取り消すことができます。 これにより、承認済み会社は、カタログ内の拡張機能パッケージの非公開バージョンを表示して、自社のプロパティにインストールできなくなります。 ただし、既にインストールされているプライベートバージョンは、削除後も引き続き期待どおりに動作します。
API 形式
DELETE //extension_package_usage_authorizations/{EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID}
EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID
ID
。リクエスト
次のDELETEリクエストは、会社の認証権限を削除します。
curl -X DELETE \
https://reactor.adobe.io/extension_package_usage_authorizations/{EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID} \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-Api-Key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H "Content-Type: application/vnd.api+json" \