---
title: "KongDirectoryRealmValues"
url: "https://nov18-dev.movespot.fyi/apis/konnect-kong-identity-admin-api-dev-0/versions/cf61fd14-4802-4fa9-ad7b-534e50226211/schemas/KongDirectoryRealmValues"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-kong-identity-admin-api-dev-0/versions/cf61fd14-4802-4fa9-ad7b-534e50226211.md

# KongDirectoryRealmValues

Configuration values used when a Kong v3 data plane connects to identity as realm. The directory is used as a realm for regional consumers.

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Konnect Kong Identity admin api
  version: 0.0.2
servers:
  - url: https://us.api.konghq.com/v2
    description: United-States Production region
  - url: https://eu.api.konghq.com/v2
    description: Europe Production region
  - url: https://au.api.konghq.com/v2
    description: Australia Production region
  - url: https://me.api.konghq.com/v2
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v2
    description: India Production region
  - url: https://sg.api.konghq.com/v2
    description: Singapore Production region
components:
  schemas:
    RealmTTL:
      description: >
        The time in minutes that the Consumer will be cached in memory on a
        running Gateway if it is

        successfully loaded from Konnect.
      type: integer
      default: 10
      minimum: 5
    NegativeTTL:
      description: >
        If a running Gateway triggers a lookup for a Consumer that cannot be
        authenticated this realm, a `negative_ttl`

        is set. The Gateway will not try to lookup the Consumer in Konnect for
        `negative_ttl` minutes.


        A Consumer will be cached for `negative_ttl` if they do not exist in the
        Realm, or if the provided credentials

        are invalid.
      type: integer
      default: 10
      minimum: 5
    RealmConsumerGroups:
      description: >
        A list of consumer groups to automatically add to any consumers created
        within this Realm.

        If `consumer_groups` are provided on the Consumer object _and_ on the
        Realm, the Consumer will be placed in all defined consumer groups.
      type: array
      items:
        type: string
        uniqueItems: true
      format: set
      title: RealmConsumerGroups
    KongDirectoryRealmValues:
      description: >
        Configuration values used when a Kong v3 data plane connects to identity
        as realm. The directory is used as a realm for regional consumers.
      type: object
      properties:
        ttl:
          $ref: "#/components/schemas/RealmTTL"
        negative_ttl:
          $ref: "#/components/schemas/NegativeTTL"
        consumer_groups:
          $ref: "#/components/schemas/RealmConsumerGroups"
      required:
        - ttl
        - negative_ttl
        - consumer_groups
```
