---
title: Kibana access agreement
description: Access agreement is a subscription feature that requires users to acknowledge and accept an agreement before accessing Kibana. The agreement text supports...
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4173/deploy-manage/users-roles/cluster-or-deployment-auth/access-agreement
products:
  - Kibana
---

# Kibana access agreement
Access agreement is a [subscription feature](https://www.elastic.co/subscriptions) that requires users to acknowledge and accept an agreement before accessing Kibana. The agreement text supports Markdown format and can be specified using the `xpack.security.authc.providers.<provider-type>.<provider-name>.accessAgreement.message` setting.
You can specify a default access agreement  using the `xpack.security.accessAgreement.message` setting. This message will be used for each provider who doesn’t specify an access agreement.
<note>
  You need to acknowledge the access agreement only once per session, and Kibana reports the acknowledgement in the audit logs.
</note>

Here is an example of defining an access agreement in [`kibana.yml`](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4173/deploy-manage/stack-settings):
```yaml
xpack.security.authc.providers:
  basic.basic1:
    order: 0
    accessAgreement:
      message: |
        **You are accessing a system with sensitive information**

        By logging in, you acknowledge that information system usage
        ...(shortened)
```

When you authenticate using `basic.basic1`, you’ll see the following agreement that you must acknowledge before you can access Kibana:
![Access Agreement UI](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4173/deploy-manage/images/kibana-access-agreement.png)