Propagate GPG Signing Keys to a Distribution Edge

JFrog REST APIs

Products
JFrog Xray
Content Type
REST API
ft:sourceType
Paligo

Description: Propagate the GPG key pair to a newly added Distribution Edge.GPG Signing

Since: 2.4

Notes: Requires Mission Control version 4.5.0 and above.

Security: Admin only

Usage: POST /api/v1/keys/{protocol: pgp|gpg}/propagate

Request headers: N/A

Consumes: application/json

From Distribution release 2.13.2, GPG keys are propagated as follows:

Propagation Behavior

Explanation

When no parameters are provided

The default key will be propagated.

When api/v1/keys/pgp/propagate?all=true

Propagates all available keys.

When api/v1/keys/pgp/propagate?alias =<alias name>

Propagates the key with the alias name.

For example, api/v1/keys/pgp/propagate?alias = 'my_key' propagates the key with the alias name my_key.

Note

Propagation is possible by either alias key or all keys but not both.

response:
{
        "report": {
                "message" : "error message if exists"
                "status" : PARTIAL_SUCCESS | SUCCESS | FAILURE | PROPAGATION_NOT_REQUESTED | PROPAGATION_NOT_SUPPORTED_BY_MISSION_CONTROL | NO_GPG_KEY_TO_PROPAGATE
                "details" : [
                        {
                                "jpd_id" : "id1",
                                "name" : "US-EAST"
                                "key_alias" : "my first key"
                                "status" : "SUCCESS"
                        },
                        {
                                "jpd_id" : "id2",
                                "name" : "US-WEST"
                                "key_alias" : "my first key"
                                "status" : "SUCCESS"
                        },
                ]
        }
}