Working with web repositories

Before you begin

• Ensure that you have the user name, password, and URL of the web repository that you want to use. You can either use a unique id or a shared id to access the web repository. The URL is the REST API URL provided by JFrog. The URL must be of the following format: 
  http://<hostname>:<port>/artifactory/<repository_path> or https://<hostname>:<port>/artifactory/<repository_path>
  
  For example, https://clm-pun-xxxxx:9091/artifactory/api/storage/bmc-local
• Ensure that you have the appropriate read permissions to access the web repository directories and installable files. 

To add a web repository

1. Select Configuration > Web Repository Management.
2. Click  to display a New Web Repository window.

3. In the New Web Repository panel, enter the following fields and click Next.

   Field	Description
   Name	Unique identifying name for the web repository.
   Description	(Optional) Description of the web repository.
   Base URL	Direct URL path that exposes the repository through HTTP or HTTPS access.
   Type	Type of the web repository. JFrog is selected by default.
   User Name	User name of the valid web repository.
   Password	Password of the web repository.

4. Click Next.

5. Using the Permissions panel, you can add individual permissions to the web repository. You can also set permissions by adding ACL templates or ACL policies. 

   Task	Description
   Adding an authorization	An authorization grants permission to a role to perform a certain type of action (add, edit, delete) on this web repository. To add authorization for this object, click Add Entry  in the Access Control List area. Then use the Add New Entry dialog box to specify the role and authorization you want to add.
   Adding an ACL template	An ACL template is a group of predefined authorizations granted to roles. Using an ACL template, you can add a group of authorizations to the web repository. To add an ACL template to the web repository, click Use ACL Template  in the Access Control List area. Then use the Select ACL Template dialog box to specify an ACL template that you want to add to this web repository. To set the contents of the selected ACL templates so that they replace all entries in the access control list, select Replace ACL with selected templates. If you do not select this option, the contents of the selected ACL templates are appended to the existing entries in the access control list.
   Adding an ACL policy	An ACL policy is a group of authorizations that can be applied to this web repository but can be managed from one location. To add an ACL policy to this object, click Use ACL Policy  in the ACL Policies area. Then use the Select ACL Policy dialog box to specify an ACL policy that you want to add to the web repository. To set the contents of the selected ACL policies so that they replace all entries in the access control list, select Replace ACL with selected policies. If you do not select this option, the contents of the selected ACL policies are appended to existing entries in the access control list.

6. Click Finish to display the newly added web repository in the panel.

To view and edit a web repository

1. Select Configuration > Web Repository Management to display the list of configured repositories.
2. Select the repository that you want to edit and click  to display the Modify Web Repository window.
3. Specify the changes to the web repository properties. 
   When you modify a repository configuration (for example, changing the base URL and user credentials), all the depot software using that configuration uses the modified configuration. 

1. Click OK to save the changes. 
   To return to the configured web repositories list without saving the changes, click Cancel. 

To delete a web repository

1. Select Configuration > Web Repository Management to display the list of configured web repositories.
2. Select the repository that you want to delete and click . A message prompts you to confirm your action.
   If the web repository configuration is used in any of the depot software, then you cannot delete the specific web repository.
3. Click Yes to delete the web repository.

Where to go from here

Now that you have configured a web repository, add software to a Depot by performing the steps mentioned in Adding-software-to-the-Depot-from-web-repository.