YMP-OAuth-Connector

YMP-OAuth-Connector — это модуль для стороннего входа в систему с использованием протокола OAuth, реализованный на основе фреймворка YMP. В настоящее время реализованы следующие возможности:

Зависимость пакета Maven

<dependency>
    <groupId>net.ymate.module</groupId>
    <artifactId>ymate-module-oauth-connector</artifactId>
    <version>1.0.1</version>
</dependency>

Создание модуля проекта

• Сначала создайте проект JavaWeb на основе YMPv2. (Как быстро создать проект? См. https://gitee.com/suninformation/ymate-platform-v2/wikis/Quickstart_New)

• Фреймворк YMP должен сканировать пакет, содержащий net.ymate.module.oauth.connector. Настройте следующим образом:

    # Список пакетов, которые фреймворк сканирует автоматически. По умолчанию уже содержит net.ymate.platform и его подпакеты, которые также будут сканироваться. Разделяйте несколько имён пакетов символом '|'
    ymp.autoscan_packages=net.ymate

Описание параметров конфигурации модуля

#-------------------------------------
# module.oauth.connector 模块初始化参数
#-------------------------------------

# Префикс имени кэша, значение по умолчанию: ""
ymp.configs.module.oauth.connector.cache_name_prefix=

# Обработчик обратного вызова соединения, значение по умолчанию — net.ymate.cms.oauth.connector.impl.DefaultConnectCallbackHandler
ymp.configs.module.oauth.connector.callback_handler_class=

# Шифрование пароля, значение по умолчанию false
ymp.configs.module.oauth.connector.password_encrypted=

# Класс обработки паролей, используется для расшифровки зашифрованных клиентских ключей OAuth. Значение по умолчанию — пустое
ymp.configs.module.oauth.connector.password_class=

#--------------------------
# Ниже приведены параметры инициализации для каждого коннектора. xxx обозначает имя коннектора, в настоящее время поддерживаются [github|wechat|qq|weibo|gitee|oschina|baidu]
#--------------------------

# Идентификатор клиента OAuth, обязательный параметр
ymp.configs.module.oauth.connector.xxx.client_id=

# Секретный ключ клиента OAuth, обязательный параметр
ymp.configs.module.oauth.connector.xxx.client_secret=

# URL-адрес перенаправления, необязательный параметр, значение по умолчанию пустое
ymp.configs.module.oauth.connector.xxx.redirect_uri=

Запуск и тестирование

• Получите и настройте идентификатор клиента и секретный ключ OAuth (вы можете получить их на странице https://github.com/settings/developers).

• В процессе подачи заявки необходимо заполнить адрес redirect_uri. Пожалуйста, заполните: http://<ваш домен>/oauth2/connect/github/redirect.

• Упакуйте проект и разверните его на целевом сервере.

• Откройте браузер и введите URL-адрес, например: http://<ваш домен>/oauth2/connect/github, чтобы протестировать авторизацию OAuth.

• Если запрос OAuth успешно авторизован, обработчик по умолчанию callback_handler_class покажет вам ответ JSON. Теперь вы можете написать реализацию интерфейса IOAuthConnectCallbackHandler для хранения информации об авторизации.

И ещё кое-что

YMP не только предоставляет удобный опыт быстрой разработки веб-приложений и других Java-проектов, но и постоянно предлагает более богатый опыт проектов.

Если вы заинтересованы, присоединяйтесь к официальной группе QQ 480374360, чтобы общаться и учиться вместе, помогая YMP расти!

Чтобы узнать больше о фреймворке YMP, посетите официальный сайт: http://www.ymate.net/.