Skip to content

Latest commit

 

History

History
55 lines (39 loc) · 4.16 KB

MANAGED.md

File metadata and controls

55 lines (39 loc) · 4.16 KB

Full managed resources

keycloak-config-cli manage some types of resources absolutely. For example if a group isn't defined inside the import json but other groups specified, keycloak-config-cli will calculate the difference and delete the group from keycloak.

In some cases it is required to include some keycloak defaults because keycloak-config-cli can't detect if the entity comes from a user or auto created by keycloak itself.

There are 2 modes to ensure a specific behavior:

1. Keycloak should not manage type of resources:

For example if you don't define any groups inside the import json, keycloak does not touch any groups.

2. Keycloak manage type of resources:

For example define any groups you want inside the import json, keycloak ensure that the groups are available but other groups will be deleted. If you define groups but set an empty array, keycloak will delete all groups in keycloak.

Supported full managed resources

Type Additional Information Resource Name
Groups - group
Required Actions You have to copy the default one to you import json. required-action
Client Scopes - client-scope
Scope Mappings - scope-mapping
Client Scope Mappings - client-scope-mapping
Roles - role
Components You have to copy the default components to you import json. component
Sub Components You have to copy the default components to you import json. sub-component
Authentication Flows You have to copy the default components to you import json, expect builtin flows authentication-flow
Identity Providers - identity-provider
Identity Provider Mappers - identity-provider-mapper
Clients - client
Clients Authorization Resources The 'Default Resource' is always included. client-authorization-resources
Clients Authorization Policies - client-authorization-policies
Clients Authorization Scopes - client-authorization-scopes

Disable deletion of managed entities

If you don't delete properties of a specific type, you can disable this behavior by default a properties like import.managed.<entity>=<full|no-delete>, e.g.: import.managed.required-actions=no-delete

State management

If import.remote-state.enabled is set to true (default value), keycloak-config-cli will purge only resources they created before by keycloak-config-cli. If import.remote-state.enabled is set to false, keycloak-config-cli will purge all existing entities if they are not defined in import json.

Supported resources

Following entities does have saved state:

  • Required Actions
  • Components