Tim's Nextcloud SSO OAuth2

Tim's Nextcloud SSO OAuth2

توسط

Just a simple OAuth2 plugin so you can login to your WordPress site from Nextcloud, there is an option to add a login button on the WordPress login page and a shortcode so you can generate your own button. You can set what Nextcloud user groups get mapped to what WordPress user role and what page the users get redirected to on successful login. If you’re using the External sites app in Nextcloud you can set the URL as www.example.com/wp-login.php?nc-sso=redirect and it will auto redirect the user to your Nextcloud install to login without them having to click the login button.

The plugin has been tested with Nextcloud 20.0.14 to 31.0.4.

If you have any problems please reach out on the support forum or directly here.

Note this isn’t an official plugin from Nextcloud, it’s just from someone that uses it with WordPress alot.

Install Tim’s Nextcloud SSO OAuth2 either via the WordPress.org plugin directory, or by uploading the files to your server.

Activate the plugin through the ‘Plugins’ menu in WordPress.

Once Active go to Settings -> Nextcloud OAuth2 in the WordPress admin area and follow the setup instructions.

سوالات متداول

How do I set the plugin up?

If you go to the settings page (Settings -> Nextcloud OAuth2) it gives you a simple breakdown of what’s needed to setup the OAuth2 connection with your Nextcloud install.

  1. Login to your Nextcloud install
  2. Go to Settings -> Security
  3. Then under “OAuth 2.0 clients” add a new client
  4. Set the name to anything you like and the redirect URL to your site URL
  5. Then copy the Client Identifier and Secret keys in the form
What’s my Nextcloud URL?

This is the URL that you have installed Nextcloud at e.g. https://cloud.example.com/, if you have installed it in a subfolder, please include that e.g. https://example.com/cloud/. If your Nextcloud URLs look like https://example.com/index.php/apps/dashboard/ then please include the /index.php/ in the URL e.g. https://example.com/index.php/.

Where is the settings page?

It’s under Settings and called “Nextcloud OAuth2”

Is there a shortcode to add a login button?

Yes, it’s [nextcloud_login class=”btn”]button text[/nextcloud_login] and there is an option to enable a button on the WordPress login screen, or you can use the URL www.example.com/wp-login.php?nc-sso=redirect

Are there any filters available so I can make my own changes?

Yes, there is:

tims_nso_authorize_url which is the Nextcloud URL the user gets redirected to, and is also the last hook before they go off to your install of Nextcloud, example:

add_filter('tims_nso_nextcloud_login_button_url', 'custom_function_name_one');
function custom_function_name_one($authorize_url){
    // custom code
    return $authorize_url;
}

tims_nso_successful_login_redirect which is the URL the user goes to after successfully coming back from Nextcloud, example:

add_filter('tims_nso_successful_login_redirect', 'custom_function_name_two');
function custom_function_name_two($redirect_url){
    // custom code
    return $redirect_url;
}

tims_nso_nextcloud_login_button_url which is the URL the login button and shortcode login button uses, example:

add_filter('tims_nso_nextcloud_login_button_url', 'custom_function_name_three');
function custom_function_name_three($url){
    // custom code
    return $url;
}

tims_nso_nextcloud_user_matched which is the WordPress WP_User (Object) and the user data (Object) from Nextcloud for the successful matched user, example:

add_filter('tims_nso_nextcloud_user_matched', 'custom_function_name_four', 10, 2);
function custom_function_name_four($user,$nextcloud){
    // custom code
    return $user;
}

I’m getting a “Nextcloud server returned but with an invalid state for this session” error

Before you go off to Nextcloud the site needs to store a unique key to verify the response when you come back, if this key is removed before you come back this is when you see this message.

By default, the key is stored in the PHP session but if you’re having trouble you can go into the plugin options and set the “Temp Key Storage Type” to use a Cookie and this should solve the issue.

I’m stuck on my Nextcloud install when I click “Grant access”, it doesn’t do anything?

If you check the JS console log and see a message like “Refused to send form data to … because it violates the following Content Security Policy directive….” then you need to edit your Nextcloud config file, usually located at nextcloud/config/config.php and add the line: ‘overwriteprotocol’ => ‘https’,

Is there a paid version?

Nope, just a simple free plugin to enable you to login to your site with Nextcloud.

I need help

If you have any problems please reach out on the support forum or directly here. I’ll try my best to help.

×
نظری برای این آیتم موجود نیست.
0 0 رای ها
امتیازدهی
اشتراک در
اطلاع از
0 نظرات
قدیمی‌ترین
تازه‌ترین بیشترین رأی
نسخه حجم فایل SHA256 تغییرات دانلود
2.0.3 35 کیلوبایت -
دانلود
×
★★★★★
★★★★★
5.0 /5 (8 نظر)

قیمت:

رایگان

نگارش

2.0.3

آخرین انتشار

21 اردیبهشت 1405

آخرین بروزرسانی

3 ماه پیش

نصب های فعال

300+

نگارش وردپرس

وردپرس 4.0.0+

تست شده از نسخه

وردپرس 6.8.5

نگارش PHP

PHP 8.0+

نسخه ها

1 نسخه