No description
Find a file
2021-11-20 13:54:36 +01:00
.github Add Dependabot configuration for Maven (#1571) 2021-11-20 13:54:36 +01:00
.husky Stop running unit tests on commit (#1148) 2021-09-13 11:28:47 +02:00
cypress Fix Cypress tests (#1569) 2021-11-18 13:55:21 +01:00
keycloak-theme Update to version 17 of NodeJS (#1387) 2021-10-21 16:31:07 +02:00
mocks Check types using ts-jest and upgrade Jest (#1178) 2021-09-17 09:33:15 +02:00
public put shared logic into common component + fixes (#1415) 2021-11-01 08:49:23 +01:00
src Fix default values for group and role mappers (#1511) 2021-11-19 15:01:14 +01:00
themes Upgrade to Snowpack 3 (#839) 2021-07-16 10:59:46 +02:00
types Configure Cypress to use the correct types (#1168) 2021-09-17 15:23:34 +02:00
.dockerignore Drop Storybook from the project (#881) 2021-07-20 16:40:45 +02:00
.eslintrc.js Prefer using arrow functions for callbacks (#1287) 2021-10-04 08:03:19 +02:00
.gitignore Drop Storybook from the project (#881) 2021-07-20 16:40:45 +02:00
.prettierrc.json added initial version of the "help system" (#26) 2020-09-02 09:51:42 +02:00
CODE_OF_CONDUCT.md Added code of conduct to project. (#150) 2020-10-07 11:14:55 -04:00
CODING_GUIDELINES.md Add section to code guidelines about non-null assertions (#889) 2021-07-22 23:32:10 +02:00
cypress.json add create client policy form; WIP (#1312) 2021-10-19 10:31:27 -04:00
Dockerfile Update Keycloak to version 15.0.2 (#1028) 2021-08-20 12:38:07 +02:00
get-version.sh Use Maven for versioning and drop NPM version (#1336) 2021-10-14 11:00:49 +02:00
import.mjs Use pre-release version of Admin Client (#1063) 2021-08-26 10:39:35 +02:00
jest.config.ts Check types using ts-jest and upgrade Jest (#1178) 2021-09-17 09:33:15 +02:00
jest.setup.ts Check types using ts-jest and upgrade Jest (#1178) 2021-09-17 09:33:15 +02:00
LICENSE Initial commit 2020-07-27 14:40:12 -04:00
package-lock.json Bump @cypress/webpack-preprocessor from 5.9.1 to 5.10.0 2021-11-18 16:33:39 +01:00
package.json Bump @cypress/webpack-preprocessor from 5.9.1 to 5.10.0 2021-11-18 16:33:39 +01:00
postcss.config.js Lint all files in the project (#1167) 2021-09-16 12:24:21 +02:00
README.md Fixed docker build for testing purposes (#895) 2021-07-27 11:24:36 +02:00
realm-settings.png fix: added build instructions 2020-08-06 17:11:12 +02:00
release.sh Add scripts needed for release. (#940) 2021-08-06 19:49:38 +02:00
security-admin-console-v2.json First page within Group section (#108) 2020-09-28 11:58:03 -04:00
set-version.sh Use Maven for versioning and drop NPM version (#1336) 2021-10-14 11:00:49 +02:00
snowpack.config.mjs Upgrade to Snowpack 3 (#839) 2021-07-16 10:59:46 +02:00
start.mjs Added progress bar and option to pass flags to standalone script (#1550) 2021-11-15 08:28:55 +01:00
tsconfig.eslint.json Lint all files in the project (#1167) 2021-09-16 12:24:21 +02:00
tsconfig.jest.json Configure Cypress to use the correct types (#1168) 2021-09-17 15:23:34 +02:00
tsconfig.json Configure Cypress to use the correct types (#1168) 2021-09-17 15:23:34 +02:00

Keycloak Admin Console V2

This project is the next generation of the Keycloak Administration Console. It is written with React and PatternFly 4.

Development Instructions

For development on this project you will need a running Keycloak server listening on port 8180.

  1. Start keycloak

    • Download and run with one command
      $> ./start.mjs
      
    • or download Keycloak server from keycloak downloads page unpack and run it like:
      $> cd <unpacked download folder>/bin
      $> standalone -Djboss.socket.binding.port-offset=100
      
  2. Go to the clients section of the existing Keycloak Admin Console and add the client

    • like this: realm settings
    • or click on the "Select file" button and import security-admin-console-v2.json
    • or run $> ./import.mjs
  3. Install dependencies and run:

    $> npm install
    $> npm run start
    

Build and run through Docker

git checkout git@github.com:keycloak/keycloak-admin-ui.git
cd keycloak-admin-ui
docker build -t keycloak-v2 .
docker run --name keycloak-v2 -d -p 127.0.0.1:8080:8080 -e KEYCLOAK_USER=admin -e KEYCLOAK_PASSWORD=admin keycloak-v2 -Dprofile.feature.newadmin=enabled

You can reach the new admin interface at http://localhost:8080. Then go to Realm Settings --> Themes and set Admin Console Theme to keycloak.v2.

If your Keycloak instance is not on localhost:8180, create a file .env with the following:

KEYCLOAK_ENDPOINT=https:\/\/remoteinstance.keycloak.com

Building as a Keycloak theme

If you want to build the application using Maven and produce a JAR that can be installed directly into Keycloak, check out the Keycloak theme documentation.

Linting

Every time you create a commit it should be automatically linted and formatted for you. It is also possible to trigger the linting manually:

npm run lint

Theming

It's possible to theme the Admin UI interface, this is useful if you want to apply your own branding so that the product looks familiar to your users. The Admin UI comes with two built-in themes called keycloak and rh-sso, by default the keycloak theme will be used when building the application.

This behavior can be changed by passing in a THEME_NAME environment variable, for example if wanted to build the application using the rh-sso theme we can do the following:

THEME_NAME=rh-sso npm run build

And likewise if we wanted to start a development server with this theme:

THEME_NAME=rh-sso npm run start

To make it simpler to build the rh-sso theme there are some shorthand NPM scripts available that you can run instead:

# Run a production build with the 'rh-sso' theme
npm run build:rh-sso

# Or for development
npm run start:rh-sso 

Creating your own theme

All themes are located in the themes/ directory of the project, if you want to create a new theme you can create a new directory here and name it the same as your theme. Copy the files from the default theme here and customize them to your liking.

Keycloak UI Test Suite in Cypress

This repository contains the UI tests for Keycloak developed with Cypress framework

Prerequisites

via Cypress Test Runner

By using npx:

note: npx is included with npm > v5.2 or can be installed separately.

npx cypress open

After a moment, the Cypress Test Runner will launch:

image

via terminal

By executing:

$(npm bin)/cypress run

...or...

./node_modules/.bin/cypress run

...or... (requires npm@5.2.0 or greater)

npx cypress run

To execute a specific test on a specific browser run:

cypress run --spec "cypress/integration/example-test.spec.js" --browser chrome

note: the complete list of parameters can be found in the official Cypress documentation.

Project Structure

/assets (added to .gitignore)
  /videos - if test fails, the video is stored here
  /screenshots - if test fails, the screenshot is stored here
/cypress
  /fixtures - external pieces of static data that can be used by your tests
  /integration - used for test files (supported filetypes are .js, .jsx, .coffee and .cjsx)
  /plugins
    - index.js - extends Cypress behaviour, custom plugins are imported before every single spec file run
  /support - reusable behaviour
    - commands.js - custom commands
    - index.js - runs before each test file

/cypress.json - Cypress configuration file
/jsconfig.json - Cypress code autocompletion is enabled here

note: More about the project structure in the official Cypress documentation.

License