Skip to main content

Guillotina based identity provider for hydra

Project description

This addon aims to provide an identity provider through guillotina for hydra.

It also implements the login and consent flow for hydra.


Trying it out

Tests require a hydra instance to be running with the following configuration:

  • OAUTH2_ISSUER_URL=http://localhost:4444
  • OAUTH2_CONSENT_URL=http://localhost:8080/@hydra-consent
  • OAUTH2_LOGIN_URL=http://localhost:8080/@hydra-login
  • DATABASE_URL=postgres://hydra:secret@postgresd:5432/hydra?sslmode=disable
  • SYSTEM_SECRET=youReallyNeedToChangeThis

Then you need to configure guillotina:

      client_id: auth-code-client
      client_secret: secret
      base_url: http://localhost:4444/
      authorize_url: http://localhost:4444/oauth2/auth
      access_token_url: http://localhost:4444/oauth2/token
    state: true
    scope: openid offline
  dsn: postgres://hydra:secret@localhost:5432/hydra
  pool_size: 20
# hydra admin url should be internal, protected!
hydra_admin_url: http://localhost:4445/

To add an oauth client to hydra:

curl -XPUT http://localhost:4445/clients/auth-code-client -d '{
    "client_id": "auth-code-client",
    "client_name": "",
    "redirect_uris": [
    "grant_types": [
    "response_types": [
    "scope": "openid offline",
    "owner": "",
    "policy_uri": "",
    "allowed_cors_origins": [],
    "tos_uri": "",
    "client_uri": "",
    "logo_uri": "",
    "contacts": [],
    "client_secret_expires_at": 0,
    "subject_type": "public",
    "jwks": {
        "keys": null
    "token_endpoint_auth_method": "client_secret_post",
    "userinfo_signed_response_alg": "none"

See for an example on using the flow.

This is just the API implementation. You will still need to implement the frontend!

Scope format

Use scopes to grant access to guillotina containers.

The format of scopes is: [container id]:[type]:[value].

For example, to give the user access to container cms as a user, the scope would be cms:role:guillotina.Member

Other examples: - cms:role:guillotina.Reader - cms:permission:guillotina.AccessContent

1.0.0 (2018-10-09)

  • initial

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for guillotina-hydraidp, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size guillotina_hydraidp-1.0.0.tar.gz (9.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page