README

通过 RealMe 为 Silverstripe 添加身份验证和身份断言支持。

此模块为 Silverstripe 应用程序与身份提供者 RealMe 的快速集成提供基础。在使用此模块之前，需要大量设置。

如果需要与 RealMe 集成，最好尽早联系 RealMe 团队。这可以通过 联系 RealMe 团队 完成。

如果您遇到任何问题，请 在此处创建新问题。

安装

composer require silverstripe/realme

为您的应用程序配置 RealMe

RealMe 提供两个测试环境和生产环境，您可以在其中进行集成。对这些环境的访问受到严格控制，更多相关信息可以在 RealMe 开发者网站 上找到。

有关在模块可以使用之前所需的配置和 YML 配置的信息，请参阅 configuration.md。

提供 RealMe 登录按钮

默认情况下，该模块在 SilverStripe 中提供了一个 Authenticator 类，添加了一个新的登录表单。如果您想为 RealMe 提供单独的登录表单，则内置模板可以帮助您完成此操作。它们已被设计为尽可能干净地与 Silverstripe 模板集成，但您是否使用它们或创建自己的模板取决于您。

有关使用或修改这些模板的更多信息，请参阅 模板文档。

身份验证测试

RealMeService 服务对象允许您在任何需要的地方注入身份验证。例如，让我们看看一个简单的 Controller，它确保所有用户都有有效的 RealMe 'FLT'（一个唯一字符串，用于标识 RealMe 用户，但不是他们的用户名）

use SilverStripe\Control\Controller;
use SilverStripe\Control\HTTPRequest;
use SilverStripe\RealMe\RealMeService;

class RealMeTestController extends Controller {
	/**
	 * @var RealMeService
	 */
	public $realMeService;

	private static $dependencies = array(
		'realMeService' => '%$SilverStripe\RealMe\RealMeService'
	);

	public function index(HTTPRequest $request) {
		// enforceLogin will redirect the user to RealMe if they're not authenticated, or return true if they are
		// authenticated with RealMe. It should only ever return 'false' if there was an error initialising config
		if($this->realMeService->enforceLogin($request)) {
			$userData = $this->realMeService->getUserData();

			printf("Congratulations, you're authenticated with a unique ID of '%s'!", $userData->SPNameID);
		} else {
			echo "There was an error while attempting to authenticate you.";
		}
	}
}

感谢

• 衷心感谢 Jackson (@jakxnz) 对拉取请求的审查和更新工作。