Page History

...

The federation has a hierarchical structure with the Trust Anchor as the root of trust. Subordinate entities include Resolvers, Intermediates, Trust Mark Issuers, OpenID Providers, and Relying Parties.

Image Added

Entities and Their Roles

Trust Anchor: Root of trust. Defines policies and signs metadata.

Resolver: Provides trust chain resolution services, enabling entities to validate metadata against the Trust Anchor.Intermediate: Manages subordinate entities and aggregates metadataBuilds and returns validated trust chains by following authority hints and subordinate statements, allowing entities to establish trust with a Trust Anchor.

Trust Mark Issuer: Issues signed Trust Marks certifying compliance with federation requirements.

Intermediate: Manages subordinate entities and aggregates metadata.

OpenID Provider: Authenticates users and issues tokens under federation policies.

...

curl -s: fetches the JWT, -s silences progress.
cut -d '.' -f2: extracts the payload from the JWT (middle part).
tr '_-' '/+': translates Base64URL alphabet into standard Base64.
base64 -d: decodes the payload.
jq .: pretty-prints the JSON.

Nodes

The following base nodes are available in the Swefed OIDF Sandboxoperated by the federation operator and form the core of the Swefed OIDF Sandbox. These nodes provide the trust anchor, resolution services, and supporting infrastructure.

Additional nodes such as OpenID Providers (OPs), Relying Parties (RPs), and further intermediates are contributed and managed by Sandbox participants.

Trust Anchor

URL: https://trust-anchor.oidf.swefed.se
Role: Root of trust. Publishes federation policies and signing keys.
Provides federation endpoints: fetch, list, resolve.

...

URL: https://trust-anchor.oidf.swefed.se (co-located with TA)
Role: Resolves The Resolver builds trust chains by processing using authority_hints and building validated chains validates signatures up to the TA.
Endpoint: /resolve.

...

URL: https://intermediate.oidf.swefed.se
Role: Aggregates and distributes metadata.
Provides federation endpoints: fetch, list, resolve.
Declares the Trust Anchor in authority_hints.

OpenID Provider

URL: https://op.oidf.swefed.se
Role: Provides authentication and token services.
Publishes OP metadata in the metadata.openid_provider section.
Trust is established dynamically through its Entity Configuration and chain to the TA.

Relying Party

URL: https://rp.oidf.swefed.se
Role: Consumes tokens and user information from OPs.
Publishes RP metadata in the metadata.openid_relying_party section.
Trust is established dynamically through its Entity Configuration and chain to the TA.

Usage Notes

...

Usage Notes

All nodes expose their Entity Configuration at /.well-known/openid-federation.
Trust chains must always be validated against the Trust Anchor.
JWT signatures must be verified with the published keys from trusted entities.
Trust Marks must be validated with the Trust Mark Issuer’s keys, provided the issuer’s trust chain resolves to the Trust Anchor.

Entity Integration

This section explains how to connect an entity to the Swefed Sandbox Trust Infrastructure. It covers metadata exposure, configuration of trust anchors, authority hints, and trust marks.

Prerequisites

Network access from your entity to the Sandbox Trust Anchor
Externally accessible HTTPS endpoint for your entity

Key Configuration Points

entity Configuration Information

The entity must expose an Entity Configuration at:

/.well-known/openid-federation

...

The configuration endpoint publishes the entity Configuration document, which provides the entity’s configuration details for participants in the Trust Infrastructure.

Define the Endpoint: The endpoint is defined under the following path: /.well-known/openid-federation
Implementation: Ensure this endpoint serves the entity’s entity Configuration.

Shortened example of an entity Configuration:

Code Block

language	js

{
  "sub": "https://my-entity.example.com",
  "authority_hints": [
    "https://my-intermediate.example.org"
  ],
  "metadata": {
    "federation_entity": {
      "organization_name": "Example Org",
      "contacts": ["support@example.com"]
    },
    "oauth_authorization_server

Entity Integration

This section explains how to connect an entity to the Swefed Sandbox Trust Infrastructure. It covers metadata exposure, configuration of trust anchors, authority hints, and trust marks.

Prerequisites

Network access from your entity to the Sandbox Trust Anchor
Externally accessible HTTPS endpoint for your entity

Key Configuration Points

entity Configuration Information

The entity must expose an entity configuration document at:

/.well-known/openid-federation

The configuration endpoint publishes the entity Configuration document, which provides the entity’s configuration details for participants in the Trust Infrastructure.

Define the Endpoint: The endpoint is defined under the following path: /.well-known/openid-federation
Implementation: Ensure this endpoint serves the entity’s entity Configuration.

Shortened example of an entity Configuration:

Code Block

language	js

{
  "sub": "https://my-entity.example.com",
  "authority_hints": [
    "https://mi-intermediate.example.org"
  ],
  "metadata": {
    "federation_entity": {
      "organizationtoken_nameendpoint": "Example Orghttps://my-entity.example.com/token",
      "contactsauthorization_endpoint": ["support@example"https://my-entity.example.com/authorize"],
    },
    "oauth_authorization_server": {
      "token_endpointjwks_uri": "https://my-entity.example.com/tokenjwks/oauth",
    }
  },
  "authorization_endpointjwks": "https://entity.example.com/authorize",{
      "jwks_uri": "https://entity.example.com/jwks/oauth"
    },
  },
  "jwks": {
    "keys": [
      {
        "kty": "RSA",
        "use": "sig",
        "kid": "example-key-id",
        "e": "AQAB",
        "n": "example-modulus"
      }
    ]
  }
}

...

The Trust Anchor is the root of the Trust Infrastructure’s federation’s trust chain. Trust Anchors establish trust within the federation by defining policies and anchoring trust It defines policies and anchors all subordinate chains.

For configuration, you must add both the Trust Anchor’s entity identifier and its public keys:

Entity ID (URL)
Trust Anchor URL: For your setup, the Trust Anchor URL is
: https://trust-anchor.oidf.swefed.se
Trust Anchor

Public Keys

: Add the Trust Anchor’s and public keys to your configuration

(JWKS):

Code Block

language	js

{
    "jwks": {
        "keyskeys": [
            {
                "kty": "RSA",
                "use": "sig",
                "kid": "d2ZPZDVKa0Z4N1J4LTB2VWM1VFFhTUdSdnU3czZKQzhwc1F1U3ZHWEV3SQJI0SzIoDD4gaEzmLUgKGj-eu5jkTpEHW1JKk7OGdyiQ",
                "en": "AQAB",
    jSDBu2-S3Z2-HN2ToJv3zQWe0lizg2VNq4Y68Xy1513nAv1fa9p1Sw5YRyhWUxCUnWnNCmGS5g11-Npqco8A7XUGzroYgOmD_1Pv0xBhOFpVQDwzLs7vmyaH2GiHDrUGBHVUJrdpjMsT5YD3xw39hQLDVlZ9qZeS4U0jUhGR4qoF5f4KuFxSb6OykDRvMcP2jSf6fvLw5oKg5b16LqLcAB-LVLC43QRXDRj1zAUMuuBa4n_dwyRG0aF2FsNsLnwvWLVGTrcSuwdnagl_T8oLLE_X5HtWQyOn0dmS_zbVZnkzxxso9usuMD4f-7BDTZq5kWRa-HUBqjpEOOcEp-ix-Q",
            "ne": "lzLK1jAEMh4duP6Ym_pHWXYJZkJ-LuJvPHqIuQrxZnEhB4ODpA0hfj9g2UdBBVzbZdhOXKg9ObTQhG_TTISDliyjKAphxF5EObMpPtCoy_ImZ262zRdK4nii6AGVuABd5777GEBIwb-zZncWypjCX-1T6CBVECi4DnoHGDHDWhBTcIa9DE6ZDAjAgrKeiDz96gOL3BrGTYHDkjIpp__FP9dZJXJjgDV2n0cvC_MDmp8N8C-Rc1vd63lpmoXxvIqBy8bSM8jXSDxPTNkcJdlducNo9sR9j-7TsGdgE9PNK-iVzyp67QnmokreMCHx3NExkmi-MfkHrPAHwE_OneNVhwAQAB"
            }},
            {
                "kty": "EC",
                "use": "sig",
                "kid": "R180Y3dtOWY2TzVoU3NYT1I2OUcyay0waWdVYVJ2YkFQZmRqaDBJZHZPMApj4FG-prDKHyUrliyQb55zFOG3jwu_ivRPWnlB9YgKc",
                "crv": "P-256",
                "x": "OSKZj-f9PT5UKWHiQ-VdhY-gfh0h-dA_weaYFqfkuUgXO0BmxPvPM7kfkfXwpXWOpF8Zm_-xwe_lfz6NWz4dxA",
                "y": "4y8u3C-CMWySQFMHN0tvafgwKWbDLS5XSQEo83HupyYtXrhZ592sNhS1h3J79_d9kB-nphMLSUkegJ99ak1s-4"
            }
        ]
    }
}

Authority Hints

The authority_hints parameter specifies the URL of the Intermediate Entities or Trust Anchors that are Immediate Superiors of the entity. This helps other Trust Infrastructure participants understand upstream trust relationships.

...

Start with this template:

Code Block

language	js

{
  "<entity-identifier>": {
{
  "<entity-identifier>": {
    "entity_types": [
      "federation_entity",
      "<additional-entity-types>"
    ],
    "jwks": {
      "keys": [
        {
          "ktyentity_types": "RSA",
    [
      "use": "sigfederation_entity",
      "<additional-entity-types>"
    "kid": "example-kid"],
    "jwks": {
      "nkeys": "example-n-value",
 [
        {
            "e": "AQAB<Key 1>"
          },
		{
			"<Key 2>"
		}
         ]
    }
  }
}

Instructions

Replace <entity-identifier> with the entity_id of your entity (typically its HTTPS URL).
Every entity must include federation_entity as one of its types.
Add the entity types that apply to your role in the Sandbox:
- openid_relying_party for RPs.
- openid_provider for OPs.
- oauth_authorization_server for entities acting as OAuth 2.0 AS.
Place your public keys in the "jwks" section. Only public key parameters are included. Private key material must never be published.

...

Code Block

language	js

{
  "https://entity.example.com": {
    "entity_types": [
      "federation_entity",
      "openid_provider",
      "oauth_authorization_server"
    ],
    "jwks": {
      "keys": [
        {
            "kty": "EC",
            "use": "sig",
    {
          "ktykid": "RSAcFFvS3F3ZEZkZXFDS3VtamR2WlI2UEFBNG9neTFMdi1JOFlNdkxHODJWOA",
            "usecrv": "sigP-256",
            "kidx": "abc123QFPmIUbY-lTLavyqzT-GqVKHCE28ng5QTWzbC3kMMJ8",
            "ny": "0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAF...vRK1LZjF3DSRqEflUwCf5obg86yWvv2Iekae7A5u35E",
            "ed": "AQABW5kLTh8IKEY0U281a7ZmGYbFAzV5kq0SjacTIufKBYM"
        }
      ]
        }
  }
}

This registration document should be submitted to the Sandbox operator to complete onboarding of the entity.

...

Trust Marks are JWTs issued by a Trust Mark entity Issuer to validate compliance with Trust Infrastructure policies.

...

The following Trust Marks are available for issuance:

Sambi:
...
- - ID: https://trust-mark.oidf.swefed.se/sambi
Retrieving Trust Marks
Trust Marks will be supplied on request.
1. Inputs to Trust Mark Issuer operator:
  - id: The identifier for the Trust Mark.
  - sub: The entity's entity Identifier.
2. Steps:
  - Supply the id and sub to the Trust Mark entityIssuer.
  - Retrieve the issued Trust Mark as a signed JWT.
3. Include in Metadata: Add issued Trust Marks to your entity’s metadata:
...
1. configuration:
Testing Trust Marks
1. Decode JWT: Use tools like jwt.io to inspect the Trust Mark's claims and ensure all required fields are present.
2. Verify Signature: Validate the JWT signature against the Trust Mark entityIssuer's public key.
3. Check Expiration: Ensure the exp claim (if present) has not expired.
4. Validate References: Follow the ref URL (if provided) to confirm compliance with human-readable policy documents.
Steps to Connect the
...
Entity
1. Configure the entity:
  - Update the entity’s configuration to include authority_hints, trust_marks, and trust_anchors.
2. Register with the Trust Infrastructure:
  - Share your entity_registration.json with the Trust Anchor or superior entity for registration.
3. Validate Configuration:
  - Test the entity using testing tools or with other entities sandbox environment.
4. Monitor the Connection:
  - Regularly verify the status and ensure Trust Marks are up-to-date.
...
1. Validate trust marks
  Use tools like jwt.io to decode and verify trust marks using the Trust Anchor's Mark Issuer’s public keys.
2. Retrieve metadata
  Ensure the .well-known/openid-federation endpoint correctly serves the entity’s entity configuration:
  Code Block
  language bash
  curl https://your-entity.example.com/.well-known/openid-federation
3. Check authority hints
  Verify that authority_hints points to the correct Superior
4. Validate public keys
  Confirm that the Trust Anchor’s public keys match those provided in your local configuration.
...

Page tree

Versions Compared

Old Version 15

New Version Current

Key

Entities and Their Roles

Nodes

Usage Notes

Usage Notes

Entity Integration

Prerequisites

Key Configuration Points

entity Configuration Information

Entity Integration

Prerequisites

Key Configuration Points

entity Configuration Information

Authority Hints

Instructions

Retrieving Trust Marks

Testing Trust Marks

Steps to Connect the

Entity