Authenticate Using OAuth - Nextcloud

This has been constructed using the Nextcloud OAuth2 Documentation combined with this issue comment on the nextcloud bugtracker.

This guide uses the generic OAuth2 module for compatibility with Nextcloud 13 and above (this guide has been tested successfully with Nextcloud 14).

Sign-in with an administrator account to your Nextcloud server.
Navigate to the OAuth integration settings: Profile Icon (top right) –> Settings.

Then choose Security Settings from the Administration part of the list - Don't confuse this with Personal Security Settings, where you would change your personal password!

At the top there's OAuth 2.0-Clients.
Add your CodiMD instance by giving it a name (perhaps CodiMD, but could be anything) and a Redirection-URI. The Redirection-URI will be \<your-codimd-url\>/auth/oauth2/callback. Click Add.
You'll now see a line containing a client identifier and a Secret.
That's it for Nextcloud, the rest is configured in your CodiMD via the CMD_ environment variables!

Add the Client ID and Client Secret to environment variables. Make sure you also replace <your-nextcloud-domain> with the right domain name.

CMD_OAUTH2_CLIENT_ID=ii4p1u3jz7dXXXXXXXXXXXXXXX
CMD_OAUTH2_CLIENT_SECRET=mqzzx6fydbXXXXXXXXXXXXXXXX
CMD_OAUTH2_AUTHORIZATION_URL=https://<your-nextcloud-domain>/apps/oauth2/authorize
CMD_OAUTH2_TOKEN_URL=https://<your-nextcloud-domain>/apps/oauth2/api/v1/token
CMD_OAUTH2_USER_PROFILE_URL=https://<your-nextcloud-domain>/ocs/v2.php/cloud/user?format=json
CMD_OAUTH2_USER_PROFILE_USERNAME_ATTR=ocs.data.id
CMD_OAUTH2_USER_PROFILE_DISPLAY_NAME_ATTR=ocs.data.display-name
CMD_OAUTH2_USER_PROFILE_EMAIL_ATTR=ocs.data.email

tags: `CodiMD` `Docs`

Guest Drake2021/01/03 08:08:28

1. Sign-in with an administrator account to your Nextcloud server. 2. Navigate to the OAuth integration settings: Profile Icon (top right) --> Settings. Then choose Security Settings from the *Administration* part of the list - Don't confuse this with Personal Security Settings, where you would change your personal password! At the top there's OAuth 2.0-Clients. ![Where to find OAuth2 in Nextcloud](https://i.imgur.com/yaoDJbf.png) 3. Add your CodiMD instance by giving it a *name* (perhaps CodiMD, but could be anything) and a *Redirection-URI*. The Redirection-URI will be `\<your-codimd-url\>/auth/oauth2/callback`. Click <kbd>Add</kbd>. ![Adding a client to Nextcloud](https://i.imgur.com/RQYOu65.png) 4. You'll now see a line containing a *client identifier* and a *Secret*. ![Successfully added OAuth2-client](https://i.imgur.com/RM7u7UT.png) 5. That's it for Nextcloud, the rest is configured in your CodiMD via the `CMD_` environment variables! 6. Add the Client ID and Client Secret to environment variables. Make sure you also replace `<your-nextcloud-domain>` with the right domain name. ``` CMD_OAUTH2_CLIENT_ID=ii4p1u3jz7dXXXXXXXXXXXXXXX CMD_OAUTH2_CLIENT_SECRET=mqzzx6fydbXXXXXXXXXXXXXXXX CMD_OAUTH2_AUTHORIZATION_URL=https://<your-nextcloud-domain>/apps/oauth2/authorize CMD_OAUTH2_TOKEN_URL=https://<your-nextcloud-domain>/apps/oauth2/api/v1/token CMD_OAUTH2_USER_PROFILE_URL=https://<your-nextcloud-domain>/ocs/v2.php/cloud/user?format=json CMD_OAUTH2_USER_PROFILE_USERNAME_ATTR=ocs.data.id CMD_OAUTH2_USER_PROFILE_DISPLAY_NAME_ATTR=ocs.data.display-name CMD_OAUTH2_USER_PROFILE_EMAIL_ATTR=ocs.data.email ```

On Nextcloud 19 and 20 you have to add /index.php to your domain to get it work. https://<your-nextcloud-domain>/index.php/.... Maybe it is the behavior if you don't have pretty URL configured within your Nextcloud. (Edited)

Authenticate Using OAuth - Nextcloud

tags: CodiMD Docs

tags: `CodiMD` `Docs`