Skip to main content
A is the integration. A connection holds the credentials Klef signs in with, the permissions those credentials carry, and the settings that decide how Klef treats the accounts it finds there. Connections can be configured under the Connections page.
The Connections page

Add a Connection

1
Navigate to the Connections page from the sidebar.
2
Click the Connect button in the toolbar.
3
Find the system you want to connect and click the Connect button.
4
Sign in to the system if prompted, or enter the credentials the connector asks for. Klef encrypts credentials at rest.See the Connectors reference for more information on what each connector needs.

Verify a Connection’s Access

1
Navigate to the Connections page and click Manage on the connection.
2
Click the Test connection button.
3
Review the results under Access check, which list each capability and whether the connection has it.
A connection's access check, listing the capabilities it has and the ones it is missing
A missing required capability means the connector cannot operate and should be fixed. Generally, this means a permission is missing on the connection. A missing recommended capability means the connector’s functionality is limited, but otherwise it can still operate. For more information on what each connection needs, see the Connectors reference.

Disable a Connection

To stop Klef from writing to a :
1
Navigate to the Connections page and click Manage on the connection.
2
Turn on Protect accounts and click the Save button.
The Protect accounts switch in a connection's settings
Once it is on, still show what would have changed, but nothing is written to the system.

Delete a Connection

Deleting a connection removes its credentials and stops its schedules. It changes nothing in the system itself, so accounts stay exactly as they are. Policies that target the system are skipped until you connect again. Klef keeps track of the accounts it managed through a deleted connection. When you connect the same account, organization or workspace again, Klef restores the deleted connection and those accounts with it. When Klef can’t tell whether new credentials reach the same account, it asks whether to restore the deleted connection or start a new one.
Do not delete a connection to re-authorize it. Edit its credentials, or click Reconnect in its settings for a connection you authorized by signing in. Klef refuses new credentials that reach a different account than the connection’s.
1
Navigate to the Connections page and click Manage on the connection.
2
Click the Delete connection button, then confirm.
The Delete connection button in a connection's settings

Connection Limitations

Currently, Klef only support one connection per system. For example, you cannot connect two Microsoft Entra tenants concurrently.

How Often Connections Sync

Klef re-reads the whole roster of each connected every 15 minutes. are not read on a schedule. Klef reads a target each time it builds a plan. If Apply plans automatically is on, that happens every 30 minutes.