Realms and Audiences

A Realm is a key value that tells the STS what claims to put in the token. You may see realm URIs in the format of urn:sharepoint.denallix.com or something that looks more like a regular URL, such as https://k2.denallix.com/Designer/. It doesn't matter what format it is in, as long as it's unique and has some claims associated with it.

You should create separate relying party trusts for each of the K2 web applications that may need to crack a claim and verify an identity, for example the K2 Designer (/Designer/), the SmartForms Runtime (/Runtime/) and View Flow (/ViewFlow) sites.

On the Realms page you can Add, Edit or Delete Realms and associated Audiences. Click on a Realm to see the associated Audiences for that Realm.

The Audience portion of the Realm is simply one or more URLs that are tied to a particular realm but that are for different services. In most cases you'll have a 1:1 mapping between Realms and Audiences, but you may have many URLs that are all tied to a single Realm. If you access your SmartForms runtime site by both https://k2.denallix.com/runtime and https://dlx:81/runtime, for example, they must both be configured as audiences for your /Runtime/ realm.

Deleting or editing Realms might break services or applications that rely on those items. Do not delete or edit these items unless you understand the impact of doing so.

Follow these steps to add Realms:

  1. Click New from the Realms view.
  2. Enter values in the fields for the new Realm, on the New Realm page.

    FieldDescription
    URIThe URI of the realm.
    Reply URIThe reply URI of the realm.
    Home RealmTypically left blank, this can be used to identify the default or home URI.
    Linked Issuers

    The issuers used for this realm. Select the required issuer:

    • K2 Form STS
    • K2 Trust for Azure AD
    • K2 Windows STS

  3. Click OK.

Follow these steps to edit Realms:

  1. Select the Realm you want to edit. Click Edit.
  2. Change the values that you want to edit, using the table in add as guidance.
  3. Click OK.

Follow these steps to delete Realms:

  1. Select the Realm you want to delete. Click Delete.
  2. Click OK to confirm you want to delete the Realm.

The Refresh button allows the refreshing of the Realms list after changes have been applied and provides an updated list of the Realms view.

The Audiences view displays a list of associated audiences for a specific Realm. Clicking on a Realm loads the associated Audiences for that Realm in the Audiences view.

Follow these steps to add Audiences to a Realm:

  1. Select the Realm you want to add an Audience to.
  2. Click New from the Audiences view.
  3. Configure the URI for the new Audience.

    FieldDescription
    URIThe URI for the audience.
  4. Click OK.

Follow these steps to edit Audiences:

  1. Select the Audience you want to edit. The Edit button becomes available.
  2. Click Edit.
  3. Change the value that you want to edit.
  4. Click OK to apply the changes.

Follow these steps to delete Audiences:

  1. Select the Audience you want to delete. Click Delete.
  2. Click OK on the dialog box to confirm you want to delete the audience.

The Refresh button refreshes the Audiences list after changes have been applied.