1Kosmos

Configuration options

The following values can be provided to the 1Kosmos Connector via the Maverics configuration file.

Domain

domain is the tenant’s 1Kosmos domain in full URL format (e.g. https://example-com.1kosmos.com).

SAML Metadata URL

samlMetadataURL is the metadata URL from the application configured in 1Kosmos. The samlMetadataURL setting will accept a file:/// URI if the metadata file is saved locally on the Orchestrator filesystem.

SAML Consumer Service URL

samlConsumerServiceURL is the URL that 1Kosmos will use to POST the SAML response back to. The Maverics SAML ACS handler will be served on this URL, so it should not conflict with the path of any application resources. The samlConsumerServiceURL path can be arbitrary (e.g. /maverics-saml or /saml-handler).

SAML Entity ID

samlEntityID is the unique application entity ID assigned to the application.

Error Page

errorPage is the page presented to the user if an error occurs.

Cache

cache is an optional field that defines the cache settings for the connector. If left undefined, the connector will use the default in-memory cache.

Examples

Basic Configuration

connectors:
  - name: onekosmos
    type: onekosmos
    samlMetadataURL: https://example-com.1kosmos.net/default/metadata
    samlConsumerServiceURL: https://maverics.example.com/1k-acs
    samlEntityID: https://example.com
    errorPage: https://example.com/login-error
    cache: redis

Configuration with local SAML metadata file

This sample assumes the SAML metadata was downloaded and saved in /etc/maverics/samlmetadata.xml.

connectors:
  - name: onekosmos
    type: onekosmos
    samlMetadataURL: file:///etc/maverics/samlmetadata.xml
    samlConsumerServiceURL: https://maverics.example.com/1k-acs
    samlEntityID: https://example.com
    errorPage: https://example.com/login-error