Edit in DokuwikiEdit in AsciidocEdit in Markdown

Token Auth configuration

PlantUML supports token authentication and this is basically the second part of an OAuth flow. This means that the token for authentication to a URL endpoint must be determined in a different way. This is only useful for tokens that are valid for a very long time (for example API keys without expiration date).

A token auth credentials configuration file must be stored in the folder configured by the property plantuml.security.credentials.path. The file extension is .credential, the file content is structured in JSON, the charset encoding is UTF-8, the filename must match the UserInfo part of the URL.

• see also
• OAuth2 configuration
• Basic Auth configuration
• General URL authentication documentation

Flow

Preparation

URL authentication

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Token auth configuration

Token auth JSON structure:

{
  "name": "<name of the configuration>",
  "type": "tokenauth",
  "properties": {
    "headers": {
      "key1": "value1",
      "key2": "value2",
      ...
    }
  },
  "proxy": {
    "type": "<proxy type>",
    "address": "<proxy server address>",
    "port": "<proxy server port>"
  }
}

• name: required
• The name of the configuration and should be similar to the file name
• type: tokenauth required
• Defines an token auth flow
• properties.headers:
• All static headers needed for the token auth flow
• proxy:
• Optional proxy configuration (overrides system proxy settings)
• proxy.type: required (direct, socks, http)
• Proxy type definition.
• proxy.address: required
• Proxy server address (hostname, IP address)
• proxy.port:
• Proxy server port number

Examples:

{
  "name": "public-api",
  "type": "tokenauth",
  "properties": {
    "headers": {
      "Authorization": "ApiKey a4db08b7-5729-4ba9-8c08-f2df493465a1"
    }
  }
}