Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fireblinkltd/fbl-plugins-keycloak-admin-client
FBL Plugin to manage Keycloak via APIs
https://github.com/fireblinkltd/fbl-plugins-keycloak-admin-client
Last synced: about 1 month ago
JSON representation
FBL Plugin to manage Keycloak via APIs
- Host: GitHub
- URL: https://github.com/fireblinkltd/fbl-plugins-keycloak-admin-client
- Owner: FireBlinkLTD
- License: mit
- Created: 2019-06-25T17:54:28.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-12-20T14:37:14.000Z (about 1 year ago)
- Last Synced: 2024-04-29T03:02:37.644Z (8 months ago)
- Language: TypeScript
- Size: 1.5 MB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FBL Plugins: Keycloak Admin Client
Manage Keycloak resources (realms, clients, roles, etc) inside your [FBL](https://fbl.fireblink.com) flows.
[![Tests](https://github.com/FireBlinkLTD/fbl-plugins-keycloak-admin-client/workflows/Tests/badge.svg)](https://github.com/FireBlinkLTD/fbl-plugins-keycloak-admin-client/actions?query=workflow%3ATests)
[![Known Vulnerabilities](https://snyk.io/test/github/FireBlinkLTD/fbl-plugins-keycloak-admin-client/badge.svg)](https://snyk.io/test/github/FireBlinkLTD/fbl-plugins-keycloak-admin-client)
[![codecov](https://codecov.io/gh/FireBlinkLTD/fbl-plugins-keycloak-admin-client/branch/master/graph/badge.svg)](https://codecov.io/gh/FireBlinkLTD/fbl-plugins-keycloak-admin-client)
[![Total alerts](https://img.shields.io/lgtm/alerts/g/FireBlinkLTD/fbl-plugins-keycloak-admin-client.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/FireBlinkLTD/fbl-plugins-keycloak-admin-client/alerts/)
[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/FireBlinkLTD/fbl-plugins-keycloak-admin-client.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/FireBlinkLTD/fbl-plugins-keycloak-admin-client/context:javascript)## Purpose
[fbl](https://fbl.fireblink.com) is a **flow** automation tool. That generally means it can automate any kind of routine processes and allows to create some really complex combinations of actions.
Keycloak management for build automation pipelines might be tricky sometimes, especially due to limited import functionality. Current plugin helps to bypass some of that limitations and seamlessly integrate with other fbl flows.
## Integration
There are multiple ways how plugin can be integrated into your flow.
### package.json
This is the most recommended way. Create `package.json` next to your flow file with following content:
```json
{
"name": "flow-name",
"version": "1.0.0",
"description": "",
"scripts": {
"fbl": "fbl"
},
"license": "UNLICENSED",
"dependencies": {
"@fbl-plguins/keycloak-admin-client": "1.1.2",
"fbl": "1.10.0"
}
}
```Then you can install dependencies as any other node module `yarn install` depending on the package manager of your choice.
After that you can use `yarn fbl ` to execute your flow or even register a custom script inside "scripts".
### Global installation
`npm i -g @fbl-plugins/keycloak-admin-client`
### Register plugin to be accessible by fbl
- via cli: `fbl -p @fbl-plguins/keycloak-admin-client `
- via flow:```yaml
requires:
fbl: '>=1.10.0 <2.0.0'
plugins:
'@fbl-plguins/keycloak-admin-client': '>=1.1.2'pipeline:
# your flow goes here
```## Action Handlers
### Realm
- [Realm Management](docs/Realm.md)
- [Realm Role Management](docs/RealmRole.md)
- [Realm Events Config](docs/RealmEventsConfig.md)### Client
- [Client Management](docs/Client.md)
- [Client Role Management](docs/ClientRole.md)
- [Client Secret](docs/ClientSecret.md)
- [Client Service Account Role Mappings](docs/ClientServiceAccountRoleMappings.md)### Group
- [Group Management](docs/Group.md)
- [Group Role Mappings](docs/GroupRoleMappings.md)### User
- [User Management](docs/User.md)
- [User Group Mappings](docs/UserGroupMappings.md)
- [User Role Mappings](docs/UserRoleMappings.md)