v1

latestOpenAPI 3.1.02026-07-17261633.4 KB

Creates federation relationship on SPIRE server

Calls spire-server federation create

post/api/v1/spire/federations

Request body

Example request

{
  "federation_relationships": [
    {
      "trust_domain": "example1.org",
      "bundle_endpoint_url": "https://bundle.example1.org",
      "https_spiffe": {
        "endpoint_spiffe_id": "spiffe://example1.org/spire-server"
      }
    }
  ]
}

Response

OK

Example response

{
  "results": [
    {
      "status": {
        "message": "OK"
      },
      "federation_relationship": {
        "trust_domain": "example1.org",
        "bundle_endpoint_url": "https://bundle.example1.org",
        "BundleEndpointProfile": {
          "HttpsSpiffe": {
            "endpoint_spiffe_id": "spiffe://example1.org/spire-server"
          }
        }
      }
    }
  ]
}