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登入