ezBookkeeping

Requirements

• ezBookkeeping v1.2.0 or higher

Create the client in Pocket ID

1. In Pocket ID, open Administration → OIDC Clients and click Add OIDC Client.
2. Enter a name such as ezBookkeeping and add the callback URL https://ezbookkeeping.example.com/oauth2/callback.
3. Click Create and copy the Client ID and the Client secret. Under Show more details, also copy the Issuer URL. The client secret is only shown once.
4. On the client’s Access tab, select the groups that may sign in under Allowed User Groups, or choose All Users.

Configure ezBookkeeping

If you configure ezBookkeeping with the configuration file, update it as shown in the example below:

[auth]
enable_oauth2_auth = true
oauth2_provider = oidc
oauth2_client_id = <client-id>
oauth2_client_secret = <client-secret>
oidc_provider_base_url = https://id.example.com
enable_oidc_display_name = true
oidc_custom_display_name = Pocket ID

If you configure ezBookkeeping with environment variables, set them as shown in the example below:

EBK_AUTH_ENABLE_OAUTH2_AUTH=true
EBK_AUTH_OAUTH2_PROVIDER=oidc
EBK_AUTH_OAUTH2_CLIENT_ID=<client-id>
EBK_AUTH_OAUTH2_CLIENT_SECRET=<client-secret>
EBK_AUTH_OIDC_PROVIDER_BASE_URL=https://id.example.com
EBK_AUTH_ENABLE_OIDC_DISPLAY_NAME=true
EBK_AUTH_OIDC_CUSTOM_DISPLAY_NAME=Pocket ID

Then restart ezBookkeeping. The login page now shows a Log in with Pocket ID button.