To get started, you will need to activate your JFrog Distribution Edges add-on and to set up your Distribution Edges by following these steps.
Step 1: Register the Distribution Edges
First, you will need to register each Distribution Edge in JFrog Mission Control. This is done by replacing the
join.key-based method with a scoped token of type pairing token using the Access Tokens tab, on the Distribution Edge.
Setting up Pairing Tokens
- In the Distribution Edge, go to the Administration tab, and then go to User Management | Access Tokens | Pairing Token.
- In the Generate Pairing Token for field, select Mission Control.
- Click Generate to generate the token.
This displays the token window, which includes the token's expiration (in seconds, set by default to 300 seconds = 5 minutes), the token ID, and the actual token.
- Copy the pairing token you generated by clicking Copy, then paste the token in a clipboard.
You will need to access this token in the steps below.
- Alternatively you can generate a scoped pairing token using the Create Pairing Token API.
The result of a pairing is the master token, which is an access token that grants the requesting service all the actions it is required to do on the issuing service, based on the given use case. The master token is usually a strong access token that can be used for several operations and is usually a long-lived token. An admin user can revoke trust by revoking this token.
Step 2: Set the GPG Keys in the Distribution Edges
From version 2.8.1, Distribution supports managing multiple pairs of GPG signing to sign Release Bundles using a set of REST APIs. You will need to get the public GPG key from Distribution via the Distribution REST API GPG Signing Keys.
If you have existing GPG keys, simply propagate the keys instead of uploading new ones. See Upload and Propagate GPG Signing Keys for Distribution.
Once you have completed these steps, you will receive an email that your JFrog Distribution Edges are ready. You will now be able to view the latest status updates and your complete topology in the MyJFrog Portal.
If you have additional Distribution Edges that you purchased but have not yet set up, follow the instructions in Manage Your Cloud Topology to set up these Edges.