Python Keycloak

For review- see https://github.com/marcospereirampj/python-keycloak

python-keycloak is a Python package providing access to the Keycloak API.

Installation

Via Pypi Package:

$ pip install python-keycloak

Manually

$ python setup.py install

Dependencies

python-keycloak depends on:

• Python 3
• requests
• python-jose
• urllib3

Tests Dependencies

• tox
• pytest
• pytest-cov
• wheel

Bug reports

Please report bugs and feature requests at https://github.com/marcospereirampj/python-keycloak/issues

Documentation

The documentation for python-keycloak is available on readthedocs.

Contributors

• Agriness Team
• Marcos Pereira
• Martin Devlin
• Shon T. Urbas
• Markus Spanier
• Remco Kranenburg
• Armin
• njordr
• Josha Inglis
• Alex
• Ewan Jone
• Lukas Martini
• Adamatics

Usage

Keycloak OpenID

Well-known

from keycloak import KeycloakOpenID

# Configure client
keycloak_openid = KeycloakOpenID(
    server_url="http://localhost:8080/",
    client_id="example_client",
    realm_name="example_realm",
    client_secret_key="secret",
)

# Get WellKnow
config_well_known = keycloak_openid.well_known()

User authentication

# Get Token
token = keycloak_openid.token("user", "password")
token = keycloak_openid.token("user", "password", totp="012345")

User info

# Get Userinfo
userinfo = keycloak_openid.userinfo(token['access_token'])

Token refresh

# Refresh token
token = keycloak_openid.refresh_token(token['refresh_token'])

# Logout
keycloak_openid.logout(token['refresh_token'])

Certificates

# Get Certs
certs = keycloak_openid.certs()

RPT

# Get RPT (Entitlement)
token = keycloak_openid.token("user", "password")
rpt = keycloak_openid.entitlement(token["access_token"], "resource_id")

# Instropect RPT
token_rpt_info = keycloak_openid.introspect(
    keycloak_openid.introspect(
        token["access_token"], rpt=rpt["rpt"], token_type_hint="requesting_party_token"
    )
)

Token inspection

# Introspect Token
token_info = keycloak_openid.introspect(token["access_token"])

# Decode Token
KEYCLOAK_PUBLIC_KEY = (
    "-----BEGIN PUBLIC KEY-----\n" + keycloak_openid.public_key() + "\n-----END PUBLIC KEY-----"
)
options = {"verify_signature": True, "verify_aud": True, "verify_exp": True}
token_info = keycloak_openid.decode_token(
    token["access_token"], key=KEYCLOAK_PUBLIC_KEY, options=options
)

Permissions

# Get permissions by token
token = keycloak_openid.token("user", "password")
keycloak_openid.load_authorization_config("example-authz-config.json")
policies = keycloak_openid.get_policies(
    token["access_token"], method_token_info="decode", key=KEYCLOAK_PUBLIC_KEY
)
permissions = keycloak_openid.get_permissions(
    token["access_token"], method_token_info="introspect"
)

UMA permissions

# Get UMA-permissions by token
token = keycloak_openid.token("user", "password")
permissions = keycloak_openid.uma_permissions(token["access_token"])

# Get UMA-permissions by token with specific resource and scope requested
token = keycloak_openid.token("user", "password")
permissions = keycloak_openid.uma_permissions(token["access_token"], permissions="Resource#Scope")

# Get auth status for a specific resource and scope by token
token = keycloak_openid.token("user", "password")
auth_status = keycloak_openid.has_uma_access(token["access_token"], "Resource#Scope")

Keycloak Admin

from keycloak import KeycloakAdmin

keycloak_admin = KeycloakAdmin(
    server_url="http://localhost:8080/auth/",
    username="example-admin",
    password="secret",
    realm_name="master",
    user_realm_name="only_if_other_realm_than_master",
    client_secret_key="client-secret",
    verify=True,
)

User handling

# Add user
new_user = keycloak_admin.create_user(
    {
        "email": "example@example.com",
        "username": "example@example.com",
        "enabled": True,
        "firstName": "Example",
        "lastName": "Example",
    }
)

# Add user and raise exception if username already exists
# exist_ok currently defaults to True for backwards compatibility reasons
new_user = keycloak_admin.create_user(
    {
        "email": "example@example.com",
        "username": "example@example.com",
        "enabled": True,
        "firstName": "Example",
        "lastName": "Example",
    },
    exist_ok=False,
)

# Add user and set password
new_user = keycloak_admin.create_user(
    {
        "email": "example@example.com",
        "username": "example@example.com",
        "enabled": True,
        "firstName": "Example",
        "lastName": "Example",
        "credentials": [
            {
                "value": "secret",
                "type": "password",
            }
        ],
    }
)

# Add user and specify a locale
new_user = keycloak_admin.create_user(
    {
        "email": "example@example.fr",
        "username": "example@example.fr",
        "enabled": True,
        "firstName": "Example",
        "lastName": "Example",
        "attributes": {"locale": ["fr"]},
    }
)

# User counter
count_users = keycloak_admin.users_count()

# Get users Returns a list of users, filtered according to query parameters
users = keycloak_admin.get_users({})

# Get user ID from name
user_id_keycloak = keycloak_admin.get_user_id("example@example.com")

# Get User
user = keycloak_admin.get_user("user-id-keycloak")

# Update User
response = keycloak_admin.update_user(
    user_id="user-id-keycloak", payload={"firstName": "Example Update"}
)

# Update User Password
response = keycloak_admin.set_user_password(
    user_id="user-id-keycloak", password="secret", temporary=True
)

# Get User Credentials
credentials = keycloak_admin.get_credentials(user_id="user_id")

# Get User Credential by ID
credential = keycloak_admin.get_credential(user_id="user_id", credential_id="credential_id")

# Delete User Credential
response = keycloak_admin.delete_credential(user_id="user_id", credential_id="credential_id")

# Delete User
response = keycloak_admin.delete_user(user_id="user-id-keycloak")

# Get consents granted by the user
consents = keycloak_admin.consents_user(user_id="user-id-keycloak")

Sending emails

# Send User Action
response = keycloak_admin.send_update_account(
    user_id="user-id-keycloak", payload=json.dumps(["UPDATE_PASSWORD"])
)

# Send Verify Email
response = keycloak_admin.send_verify_email(user_id="user-id-keycloak")

User sessions

# Get sessions associated with the user
sessions = keycloak_admin.get_sessions(user_id="user-id-keycloak")

Server info

# Get themes, social providers, auth providers, and event listeners available on this server
server_info = keycloak_admin.get_server_info()

Clients handling

# Get clients belonging to the realm Returns a list of clients belonging to the realm
clients = keycloak_admin.get_clients()

# Get client - id (not client-id) from client by name
client_id = keycloak_admin.get_client_id("my-client")

# Get representation of the client - id of client (not client-id)
client = keycloak_admin.get_client(client_id="client_id")

Roles handling

# Get all roles for the realm or client
realm_roles = keycloak_admin.get_realm_roles()

# Get all roles for the client
client_roles = keycloak_admin.get_client_roles(client_id="client_id")

# Get client role
role = keycloak_admin.get_client_role(client_id="client_id", role_name="role_name")

# Warning: Deprecated
# Get client role id from name
role_id = keycloak_admin.get_client_role_id(client_id="client_id", role_name="test")

# Create client role
keycloak_admin.create_client_role(
    client_role_id="client_id", payload={"name": "roleName", "clientRole": True}
)

# Assign client role to user. Note that BOTH role_name and role_id appear to be required.
keycloak_admin.assign_client_role(
    client_id="client_id", user_id="user_id", role_id="role_id", role_name="test"
)

# Retrieve client roles of a user.
keycloak_admin.get_client_roles_of_user(user_id="user_id", client_id="client_id")

# Retrieve available client roles of a user.
keycloak_admin.get_available_client_roles_of_user(user_id="user_id", client_id="client_id")

# Retrieve composite client roles of a user.
keycloak_admin.get_composite_client_roles_of_user(user_id="user_id", client_id="client_id")

# Delete client roles of a user.
keycloak_admin.delete_client_roles_of_user(
    client_id="client_id", user_id="user_id", roles={"id": "role-id"}
)
keycloak_admin.delete_client_roles_of_user(
    client_id="client_id", user_id="user_id", roles=[{"id": "role-id_1"}, {"id": "role-id_2"}]
)
# Get client role id from name
role_id = keycloak_admin.get_client_role_id(client_id=client_id, role_name="test")

# Get all roles for the realm or client
realm_roles = keycloak_admin.get_roles()

# Assign client role to user. Note that BOTH role_name and role_id appear to be required.
keycloak_admin.assign_client_role(
    client_id=client_id, user_id=user_id, role_id=role_id, role_name="test"
)

# Assign realm roles to user
keycloak_admin.assign_realm_roles(user_id=user_id, roles=realm_roles)

Authorization services

# Get all client authorization resources
client_resources = get_client_authz_resources(client_id="client_id")

# Get all client authorization scopes
client_scopes = get_client_authz_scopes(client_id="client_id")

# Get all client authorization permissions
client_permissions = get_client_authz_permissions(client_id="client_id")

# Get all client authorization policies
client_policies = get_client_authz_policies(client_id="client_id")

Groups handling

# Create new group
group = keycloak_admin.create_group({"name": "Example Group"})

# Get all groups
groups = keycloak_admin.get_groups()

# Get group
group = keycloak_admin.get_group(group_id="group_id")

# Get group by name
group = keycloak_admin.get_group_by_path(path="/group/subgroup", search_in_subgroups=True)

# Function to trigger user sync from provider
sync_users(storage_id="storage_di", action="action")

Identity providers

# Get all ID Providers
idps = keycloak_admin.get_idps()

Realm handling

# Create a new Realm
keycloak_admin.create_realm(payload={"realm": "demo"}, skip_exists=False)