Skip to content

Latest commit

 

History

History
82 lines (54 loc) · 3.9 KB

catalog-other-share.md

File metadata and controls

82 lines (54 loc) · 3.9 KB
Raw
copyright lastupdated keywords subcollection
years
2021, 2023
2023-05-22
account, publish, private catalog, allowlist, external
account

{{site.data.keyword.attribute-definition-list}}

Publishing products to specific accounts

{: #catalog-other-publish}

If you don't want your product to be publicly available to all users in the {{site.data.keyword.cloud}} catalog but you do want certain accounts to be able to access your product, you can publish your product to specific allowlisted accounts if your product is approved for publishing. {: shortdesc}

A different process is used if you want to share your product with users in your own enterprise or account or to enterprises to which you have the Editor role or higher already assigned, and it does not require approval for publishing. For more information, see Sharing private catalog products.

Before you begin

{: #prereqs-share-enterprise}

  1. Ensure that your product is approved to publish.

  2. You must be assigned the Administrator role for the Catalog Management account management service in the same account as your product. For more information, see Assigning users access.

  3. Verify that at least one version of your product is in the ready state.

  4. Retrieve the ID of the account that you want to publish to. For more information, see Can I view my account ID, account type, and account number?.

    If you don't have access to the account, a user that does have access must share the ID with you. {: important}

Publishing products to specific accounts by using the console

{: #other-publish-steps} {: ui}

When you publish your product to specific accounts, the accounts are added to a list of IDs that are granted access to your product also known as the allowlist. Any ID that is not included in the allowlist can't access your product.

To manage the allowlist and publish your product to specific accounts, complete the following steps:

  1. In the {{site.data.keyword.cloud_notm}} console, click Manage > Catalogs > Private catalogs.

  2. Select the private catalog where your product is located.

  3. Select the product that you want to publish.

  4. Click Actions... > Publish.

  5. Select Publish to a set of accounts.

  6. Select Publish to other accounts.

  7. Click Add accounts > Account.

  8. Enter the ID of the account that you want to publish your product to.

    If you are already a member of the account that you want to publish to, you can click Add your accounts to choose from a list. {: tip}

  9. Click Add > Publish.

Publishing products to specific accounts by using the CLI

{: #other-publish-steps-cli} {: cli}

To publish your product to specific accounts, run the ibmcloud catalog offering publish allowlist. To run the command, you must include the catalog ID where the product is located, the product name or ID, and the account IDs that you would like to add to the allowlist.

When you publish your product to specific accounts, the accounts are added to a list of IDs that are granted access to your product also known as the allowlist. Any ID that is not included in the allowlist cannot access your product. {: note}

ibmcloud catalog offering publish allowlist [--catalog CATALOG][--offering OFFERING][--account-ids ACCOUNT-IDS].

{: codeblock}

Example command

{: #other-publish-example}

Add the account ID 1 to the allowlist for the product Product that is located in the A private catalog.

ibmcloud catalog offering publish allowlist --catalog A --offering Product --account-ids 1

{: codeblock}