https://github.com/cloud-apim/otoroshi-biscuit-studio
Cloud APIM - Otoroshi Biscuit Studio
https://github.com/cloud-apim/otoroshi-biscuit-studio
authentication authorization biscuit biscuit-studio eclipse-biscuit otoroshi token-based-authentication
Last synced: 18 days ago
JSON representation
Cloud APIM - Otoroshi Biscuit Studio
- Host: GitHub
- URL: https://github.com/cloud-apim/otoroshi-biscuit-studio
- Owner: cloud-apim
- License: apache-2.0
- Created: 2024-12-11T13:17:11.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-01T13:04:33.000Z (about 1 month ago)
- Last Synced: 2026-01-06T13:22:28.416Z (28 days ago)
- Topics: authentication, authorization, biscuit, biscuit-studio, eclipse-biscuit, otoroshi, token-based-authentication
- Language: Scala
- Homepage: https://cloud-apim.github.io/otoroshi-biscuit-studio/
- Size: 14.8 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Notice: NOTICE
Awesome Lists containing this project
README
# Cloud APIM - Otoroshi Biscuit Studio
[](https://github.com/cloud-apim/otoroshi-biscuit-studio/actions/workflows/test-extension.yml)
The Otoroshi Biscuit Studio is set of [Otoroshi](https://github.com/MAIF/otoroshi) plugins to use Biscuit Tokens into your Gateway.
## Reference Documentation
The Otoroshi Biscuit Studio documentation is available here : https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/overview
## Installation
Follow this guide in order to get Otoroshi with the Biscuit Studio Extension.
### Download Otoroshi
[  ](https://github.com/MAIF/otoroshi/releases/download/v17.11.0/otoroshi.jar)
```sh
curl -L -o otoroshi.jar 'https://github.com/MAIF/otoroshi/releases/download/v17.11.0/otoroshi.jar'
```
### Download the Biscuit Studio extension
[ ](https://github.com/cloud-apim/otoroshi-biscuit-studio/releases/download/1.7.0/otoroshi-biscuit-studio-1.7.0.jar)
You can download the latest release of `otoroshi-biscuit-studio` from https://github.com/cloud-apim/otoroshi-biscuit-studio/releases/latest
```sh
curl -L -o biscuit-studio-extension.jar 'https://github.com/cloud-apim/otoroshi-biscuit-studio/releases/download/1.7.0/otoroshi-biscuit-studio-1.7.0.jar'
```
### Run Otoroshi with the Biscuit Studio Extension
```sh
java -cp "./biscuit-studio-extension.jar:./otoroshi.jar" -Dotoroshi.adminLogin=admin -Dotoroshi.adminPassword=password -Dotoroshi.storage=file play.core.server.ProdServerStart
```
Open http://otoroshi.oto.tools:8080/ in your browser
Default Otoroshi UI credentials : admin / password
## Entities
- [KeyPairs](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/entities/keypairs)
- [Verifiers](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/entities/verifiers)
- [Attenuators](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/entities/attenuators)
- [RBAC Policies](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/entities/rbac)
- [Remote Facts Loader](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/entities/remotefacts)
- [Forges](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/entities/forges)
## Plugins
- [Verifier plugin](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/plugins/verifiers)
- [Attenuator plugin](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/plugins/attenuators)
- [Client Credentials plugin](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/plugins/clientcredentials)
- [Biscuit to User plugin](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/plugins/biscuit-user-extractor)
- [User to Biscuit plugin](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/plugins/user-to-biscuit)
- [Biscuit to ApiKey Bridge Plugin](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/plugins/apikeybridge)
- [Public Keys exposition](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/plugins/keypairsexposition)
### Biscuit Studio API Reference
[API Reference](https://cloud-apim.github.io/otoroshi-biscuit-studio/docs/api)
## Funding
This project was funded by the French Government under the [France 2030 plan](https://www.economie.gouv.fr/france-2030), operated by [Cap Digital](https://www.capdigital.com/) and [Bpifrance](https://www.bpifrance.fr/), and is supported by the European Union – [NextGenerationEU](https://next-generation-eu.europa.eu/).
