Skip to content
Snippets Groups Projects
Commit ce6fbd39 authored by Denis Sukhoroslov's avatar Denis Sukhoroslov
Browse files

issue #14, doc fixes

parent a9d90cf8
No related branches found
No related tags found
No related merge requests found
......@@ -5,35 +5,13 @@
This is a Reference Implementation of GAIA-X LOT1 [Authentication & Authorization Service](https://www.gxfs.eu/authentication-authorisation/).
## Documentation
All service documentation, installation instructions and other materials can be found in the [AAS documentation section](./doc).
All service documentation, installation instructions and other materials can be found in the [AAS documentation](./doc) section.
## Support
To get support you can open an issue in the project [Issues](https://gitlab.com/gaia-x/data-infrastructure-federation-services/authenticationauthorization/-/issues) section.
## Getting Started
To start with AAS project download it to your local machine, go to project's root folder and build it with maven:
>mvn clean install
After all artifacts are ready you can run local image with docker compose:
>cd docker
>docker-compose up
The running image contains a pre-configured Keycloak instance and an instance of AA service. It also contains an instance of Demo application protected by AAS and IAM (keycloak). To test how the image works try to open in your browser protected resource from Demo app: `http://test-server:8990/demo`. If you're not authenticated yet you'll be redirected to the Keycloak login page:
![Keycloak login](./doc/images/keycloak_login.png "Keycloak login")
<br>
Click on the SSI OIDC Broker button - then you will be redirected to AAS login page:
<br>
![AAS login](./doc/images/aas_login.png "AAS login")
After scanning QR code please press the Login button - then AAS will authenticate you and you'll get access to the Demo application.
To start with AAS project see detailed instruction at [Build Procedures](./doc/build) section.
## Roadmap
The project is in the development phase how. We're going to implement all required functionality till the end of April 2022 and then test and stabilize it during May and June 2022.
......
......@@ -28,4 +28,12 @@ To test locally how AAS, IAM and Demo application protected with IAM work togeth
127.0.0.1 key-server
127.0.0.1 test-server
```
Then you can test how OIDC Authentication Flow works accessing http://test-server:8990/demo endpoint. You should be redirected to Keycloak Login page. Choose OIDC Broker option - then you'll be redirected to GAIA-X custom Login page. Press Login button - now you'll get access to protected Demo application.
On the first start we must set expected secret values for predefined SSI Identity Providers. To do this please open keycloak admin console at `http://key-server:8080/admin`, select `Gaia-X` realm, go to Identity Providers section and set proper Client Secret values:
- SSI OIDC Broker secret is 'secret'
- SSI SIOP Broker secret is 'secret2'
Then you can test how OIDC Authentication Flow works accessing `http://test-server:8990/demo` endpoint. You should be redirected to Keycloak Login page:
![Keycloak login](../../images/keycloak_login.png "Keycloak login")
Choose OIDC Broker option - then you'll be redirected to GAIA-X custom Login page. After some time you'll be automatically authenticated and redirected back to the protected Demo application.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment