authelia/docs/content/en/integration/openid-connect/nextcloud/index.md

title	description	lead	date	draft	images	menu	weight	toc	community
Nextcloud	Integrating Nextcloud with the Authelia OpenID Connect Provider.		2022-06-15T17:51:47+10:00	false		integration parent openid-connect	620	true	true

Tested Versions

• Authelia
  • v4.35.5
• Nextcloud
  • 22.1.0

Before You Begin

{{% oidc-common %}}

Assumptions

This example makes the following assumptions:

• Application Root URL: https://nextcloud.example.com
• Authelia Root URL: https://auth.example.com
• Client ID: nextcloud
• Client Secret: insecure_secret

Important Note: it has been reported that some of the Nextcloud plugins do not properly encode the client secret. as such it's important to only use alphanumeric characters as well as the other RFC3986 Unreserved Characters. We recommend using the generating client secrets guidance above.

Configuration

Application

To configure Nextcloud to utilize Authelia as an OpenID Connect 1.0 Provider:

1. Install the Nextcloud OpenID Connect Login app
2. Add the following to the Nextcloud config.php configuration:

$CONFIG = array (
    'allow_user_to_change_display_name' => false,
    'lost_password_link' => 'disabled',
    'oidc_login_provider_url' => 'https://auth.example.com',
    'oidc_login_client_id' => 'nextcloud',
    'oidc_login_client_secret' => 'insecure_secret',
    'oidc_login_auto_redirect' => false,
    'oidc_login_end_session_redirect' => false,
    'oidc_login_button_text' => 'Log in with Authelia',
    'oidc_login_hide_password_form' => false,
    'oidc_login_use_id_token' => true,
    'oidc_login_attributes' => array (
        'id' => 'preferred_username',
        'name' => 'name',
        'mail' => 'email',
        'groups' => 'groups',
    ),
    'oidc_login_default_group' => 'oidc',
    'oidc_login_use_external_storage' => false,
    'oidc_login_scope' => 'openid profile email groups',
    'oidc_login_proxy_ldap' => false,
    'oidc_login_disable_registration' => true,
    'oidc_login_redir_fallback' => false,
    'oidc_login_alt_login_page' => 'assets/login.php',
    'oidc_login_tls_verify' => true,
    'oidc_create_groups' => false,
    'oidc_login_webdav_enabled' => false,
    'oidc_login_password_authentication' => false,
    'oidc_login_public_key_caching_time' => 86400,
    'oidc_login_min_time_between_jwks_requests' => 10,
    'oidc_login_well_known_caching_time' => 86400,
    'oidc_login_update_avatar' => false,
);

Authelia

The following YAML configuration is an example Authelia client configuration for use with Nextcloud which will operate with the above example:

identity_providers:
  oidc:
    ## The other portions of the mandatory OpenID Connect 1.0 configuration go here.
    ## See: https://www.authelia.com/c/oidc
    clients:
    - id: 'nextcloud'
      description: 'NextCloud'
      secret: '$pbkdf2-sha512$310000$c8p78n7pUMln0jzvd4aK4Q$JNRBzwAo0ek5qKn50cFzzvE9RXV88h1wJn5KGiHrD0YKtZaR/nCb2CJPOsKaPK0hjf.9yHxzQGZziziccp6Yng'  # The digest of 'insecure_secret'.
      public: false
      authorization_policy: 'two_factor'
      redirect_uris:
        - 'https://nextcloud.example.com/apps/oidc_login/oidc'
      scopes:
        - 'openid'
        - 'profile'
        - 'email'
        - 'groups'
      userinfo_signing_alg: 'none'

See Also

• Nextcloud OpenID Connect Login app
• Nextcloud OpenID Connect Login Documentation