uaa下载 - uaa源码下载

uaa

其他源码

77.19.0

下载

松弛#uaa

CloudFoundry 用户帐户和身份验证 (UAA) 服务器

UAA 是一种多租户身份管理服务，在 Cloud Foundry 中使用，但也可用作独立的 OAuth2 服务器。它的主要角色是作为 OAuth2 提供商，为客户端应用程序颁发令牌以供客户端应用程序代表 Cloud Foundry 用户操作时使用。它还可以使用 Cloud Foundry 凭据对用户进行身份验证，并可以使用这些凭据（或其他凭据）充当 SSO 服务。它具有用于管理用户帐户和注册 OAuth2 客户端的端点，以及各种其他管理功能。

UAA服务器

身份验证服务是uaa 。这是一个简单的 Spring MVC Web 应用程序。在 Tomcat 或您选择的容器中正常部署，或执行./gradlew run直接从源树中的uaa目录运行它。使用 gradle 运行时，它侦听端口 8080，URL 为http://localhost:8080/uaa

UAA 服务器支持 UAA-API 文档中定义的 API。总结一下：

OAuth2 /oauth/authorize 和 /oauth/token 端点
/login_info 端点允许查询所需的登录提示
/check_token 端点，允许资源服务器获取有关 OAuth2 客户端提交的访问令牌的信息。
/token_key 端点，允许资源服务器获取验证密钥以验证令牌签名
SCIM 用户配置端点
OpenID 连接端点以支持身份验证/用户信息。部分 OpenID 支持。

命令行客户端可以通过直接向/oauth/authorize端点提交凭据来执行身份验证（如 UAA-API 文档中所述）。如果您的客户端是 Java，Spring Security OAuth 中有一个ImplicitAccessTokenProvider可以完成繁重的工作。

使用案例

认证
```
 GET /login
```
基本表单登录界面。

批准 OAuth2 令牌授予

 GET /oauth/authorize?client_id=app&response_type=code...

标准 OAuth2 授权端点。

获取访问令牌
```
 POST /oauth/token
```
标准 OAuth2 授权端点。

坐标

代币：关于代币、范围和权限的说明
技术论坛：cf-dev 邮件列表
文档：文档/
API 文档：http://docs.cloudfoundry.org/api/uaa/
规范：OpenID Connect 核心框架，包括 Oauth 2 授权框架
LDAP：UAA LDAP 集成

快速入门

要求：

爪哇17

如果这有效，您就可以从事商业活动：

 $ git clone git://github.com/cloudfoundry/uaa.git
$ cd uaa
$ ./gradlew run

这些应用程序都与在/uaa 、 /app和/api相同端口 (8080) 上运行的应用程序一起工作。

UAA 将记录到名为uaa.log的文件中，可以使用以下命令找到该文件：-

 $ sudo lsof | grep uaa.log

您应该在以下内容下找到：-

 $TMPDIR/cargo/conf/logs/

本地服务器上的命令行使用演示

首先按上述方式运行 UAA 服务器：

 $ ./gradlew run

从另一个终端，您可以使用curl通过请求系统信息来验证UAA是否已启动：

 $ curl --silent --show-error --head localhost:8080/uaa/login | head -1
HTTP/1.1 200

对于复杂的请求，使用 UAA 命令行客户端uaac与 UAA 交互会更方便。

调试本地服务器

要加载 JDWP 代理以进行 UAA jvm 调试，请按如下方式启动服务器：

./gradlew run -Dxdebug=true

或者

./gradlew -Dspring.profiles.active=default,hsqldb,debug run

然后，您可以将调试器附加到 jvm 进程的端口 5005。

要挂起服务器启动直到附加调试器（对于调试启动代码很有用），请按如下方式启动服务器：

./gradlew run -Dxdebugs=true

或者

./gradlew -Dspring.profiles.active=default,hsqldb,debugs run

使用不同的数据库运行本地 UAA 服务器

./gradlew run默认使用 hsqldb 数据库运行 UAA 服务器。

数据库

启动mysql服务器（例如mysql docker容器）

% docker run --name mysql1 -e MYSQL_ROOT_PASSWORD=changeme -d -p3306:3306 mysql

创建uaa数据库（例如在mysql交互会话中）

% mysql -h 127.0.0.1 -u root -p
...
mysql > create database uaa ;

使用 mysql 配置文件运行 UAA 服务器

% ./gradlew -Dspring.profiles.active=mysql,default run

PostgreSQL

启动 postgresql 服务器（例如 postgres docker 容器）

docker run --name postgres1 -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword -d postgres

创建uaa数据库（例如在psql交互会话中）

% psql -h 127.0.0.1 -U postgres

 create database uaa;
create user root with superuser password 'changeme';

使用 postgresql 配置文件运行 UAA 服务器

% ./gradlew -Dspring.profiles.active=postgresql,default run

UAA 服务器启动后，您可以看到 uaa 数据库中创建的表（例如在 psql 交互会话中）

 c uaa
psql (14.5 (Homebrew), server 15.0 (Debian 15.0-1.pgdg110+1))
WARNING: psql major version 14, server major version 15.
         Some psql features might not work.
You are now connected to database "uaa" as user "postgres".
d
List of relations
 Schema |             Name              |   Type   | Owner
--------+-------------------------------+----------+-------
 public | authz_approvals               | table    | root
 public | expiring_code_store           | table    | root
 public | external_group_mapping        | table    | root
 public | external_group_mapping_id_seq | sequence | root
 public | group_membership              | table    | root
 public | group_membership_id_seq       | sequence | root
 public | groups                        | table    | root
 public | identity_provider             | table    | root
 public | identity_zone                 | table    | root
 public | oauth_client_details          | table    | root
 public | oauth_code                    | table    | root
 public | oauth_code_id_seq             | sequence | root
 public | revocable_tokens              | table    | root
 public | schema_version                | table    | root
 public | sec_audit                     | table    | root
 public | sec_audit_id_seq              | sequence | root
 public | spring_session                | table    | root
 public | spring_session_attributes     | table    | root
 public | user_info                     | table    | root
 public | users                         | table    | root
(23 rows)

运行测试

您可以使用 docker 运行集成测试

 $ run-integration-tests.sh <dbtype>

将创建一个运行 uaa + ldap + 数据库的 docker 容器，用于运行集成测试。

使用 Gradle 与 postgresql 或 mysql 进行测试

默认的 uaa 单元测试（./gradlew testintegrationTest）使用 hsqldb。

要使用 docker 运行单元测试：

 $ run-unit-tests.sh <dbtype>

运行单个测试

默认的 uaa 单元测试 ( ./gradlew test ) 使用 hsqldb。

首先找出您的测试属于哪个 gradle 项目。您可以通过运行找到所有项目

 $ ./gradlew projects

要运行特定的测试类，您可以指定模块和测试类。

 $ ./gradlew :<project name>:test --tests <TestClass>.<MethodName>

在此示例中，它仅运行 cloudfoundry-identity-server 模块中的 JdbcScimGroupMembershipManagerTests 测试：

 $ ./gradlew :cloudfoundry-identity-server:test 
--tests "org.cloudfoundry.identity.uaa.scim.jdbc.JdbcScimGroupMembershipManagerTests"

或运行类中的所有测试

 $ ./gradlew :<project name>:test --tests <TestClass>

您可能希望通过将项目名称添加到test命令并添加--tests选项来使用位于scripts/unit-tests.sh脚本底部的完整 gradle 命令。

构建战争文件

 $ ./gradlew :clean :assemble -Pversion=${UAA_VERSION}

存货

这里实际上有几个项目，主要的uaa服务器应用程序、客户端库和一些示例：

uaa一个易于部署的 WAR 项目
server包含 UAA 的 REST API（包括 SCIM）和 UI 的实现的 JAR 项目
为客户端库和服务器使用的 JAR 项目model
api （示例）是一个 OAuth2 资源服务，它返回已部署应用程序的模拟列表
app （示例）是一个使用上述两者的用户应用程序

在 CloudFoundry 术语中

uaa为后端服务和应用程序提供身份验证服务和授权委托（通过颁发 OAuth2 访问令牌）。
api是一种服务，它提供其他应用程序可能希望代表资源所有者（最终用户）访问的资源。
app是一个 web 应用程序，需要单点登录并代表用户访问api服务。

在 Kubernetes 上运行 UAA

先决条件

ytt，使用 0.24.0 进行测试
库贝克特尔

Kubernetes 部署正在积极开发中。您应该预料到频繁的（并且可能是破坏性的）变化。此部分将随着此功能集的进展而更新。截至目前：

K8s 目录包含可渲染并应用于 K8s 集群的ytt模板。

在开发中，该 Makefile 可用于常见的渲染和部署活动。

在生产中，您很可能希望直接使用 ytt。像这样的事情应该让你继续：

$ ytt -f templates -f values/default-values.yml | kubectl apply -f -

如果您想覆盖其中一些值，可以利用 YTT 的覆盖功能来实现。

$ ytt -f templates -f values/default-values.yml -f your-dir/production-values.yml | kubectl apply -f -

当然，您始终可以完全放弃默认值并提供您自己的值文件。

为UAA做出贡献

您可以通过以下一些方式参与社区：

在 slack 上加入 uaa #uaa
为错误和新功能创建 github 票证，并对您感兴趣的功能进行评论和投票。
Github 用于社交编码：如果您想编写代码，我们鼓励通过来自此存储库的分支的拉取请求进行贡献。如果您想以这种方式贡献代码，请参考现有问题（如果也有涵盖您正在解决的特定问题的问题）。始终向“开发”分支提交拉取请求。我们严格遵守测试驱动开发。我们恳请拉取请求附带测试用例，如果与拉取请求分开运行，这些测试用例将会失败。
创建拉取请求后，您可以自己检查代码指标
在 Github Actions 和 Sonar 上。新代码的目标应该接近 100% 经过测试且干净的代码：

将 UAA 连接到本地 LDAP 服务器

要求：

码头工人
Docker 组合

为了调试 UAA 和 LDAP 集成，我们使用 VMWare 的 Bitnami 项目中的 OpenLdap docker 映像

修改文件uaa/src/main/resources/uaa.yml并通过取消注释第 7 行spring_profiles: ldap,default,hsqldb来启用 LDAP
从目录scripts/ldap运行docker-compose up
从scripts/ldap通过运行docker-confirm-ldapquery.sh验证与运行 OpenLdap 容器的连接
使用./gradlew run启动 UAA
导航到/uaa并使用 LDAP 用户user01和密码password1登录