-
Notifications
You must be signed in to change notification settings - Fork 20
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #193 from 3scale/fix-read-integrate-doc
[Doc] [Integrate] Fix spaces and mention the right queue
- Loading branch information
Showing
1 changed file
with
12 additions
and
11 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,34 +1,35 @@ | ||
# Local integration between Porta/System with Keycloak through Zync | ||
Install these 3 components to have a complete integration of managed SSO applications in Porta. | ||
|
||
1. Install Porta | ||
1. Install Porta | ||
Follow [the installation guide](https://github.com/3scale/porta/blob/master/INSTALL.md). | ||
|
||
2. Install Zync | ||
2. Install Zync | ||
Follow [the installation guide](https://github.com/3scale/zync/blob/master/INSTALL.md). | ||
|
||
3. Install Keycloak | ||
3. Install Keycloak | ||
Run Keycloak locally. | ||
`docker run --name keycloak -d -p 8080:8080 -e KEYCLOAK_USER=admin -e KEYCLOAK_PASSWORD=p jboss/keycloak` | ||
|
||
Then [configure Red Hat Single Sign-On](https://access.redhat.com/documentation/en-us/red_hat_3scale_api_management/2.4/html/api_authentication/openid-connect#configure_red_hat_single_sign_on). | ||
|
||
4. Run Zync | ||
4. Run Zync | ||
Go to the folder where you have zync installed and run it in the port 5000. | ||
`ZYNC_AUTHENTICATION_TOKEN=zynctoken bundle exec rails server -p 5000` | ||
|
||
5. Run Porta | ||
5. Run Porta | ||
|
||
These configurations are needed: | ||
- In `config/rolling_updates.yml`, make sure to have `apicast_v2: true` and `apicast_oidc: true`. | ||
|
||
Run porta. | ||
Run porta. | ||
`UNICORN_WORKERS=8 ZYNC_ENDPOINT=http://localhost:5000 ZYNC_AUTHENTICATION_TOKEN=zynctoken bundle exec rails server -b 0.0.0.0` | ||
|
||
6. Run Porta's sidekiq | ||
Run Porta's Sidekiq to process Zync Worker jobs from the `low` queue. | ||
6. Run Porta's sidekiq | ||
Run Porta's Sidekiq to process Zync Worker jobs from the `zync` queue. | ||
`ZYNC_ENDPOINT=http://localhost:5000 ZYNC_AUTHENTICATION_TOKEN=zynctoken bundle exec sidekiq -q zync` | ||
|
||
7. Configure 3scale to use Keycloak | ||
Follow the documentation to [configure 3scale](https://access.redhat.com/documentation/en-us/red_hat_3scale_api_management/2.4/html/api_authentication/openid-connect#configure_3scale). | ||
The url must not contain 'locahost', but it is possible to use instead `keycloak.lvh.me:8080` | ||
7. Configure 3scale to use Keycloak | ||
Follow the documentation to [configure 3scale](https://access.redhat.com/documentation/en-us/red_hat_3scale_api_management/2.4/html/api_authentication/openid-connect#configure_3scale). | ||
The url must not contain 'locahost', but it is possible to use instead `keycloak.lvh.me:8080` | ||
Example of the whole url: `http://threescale:[email protected]:8080/auth/realms/3scale` |