Frequently asked questions

The questions teams ask before running Beffroi OP in front of their users.

Is Beffroi OpenID certified?
Beffroi runs the conformance suite of the OpenID Foundation every week, in strict mode, from Basic OP to FAPI 2.0 and FAPI-CIBA. The OpenID Certified mark is a filing with the foundation, which the project has not made yet; it will be announced on the conformance page once it is. Conformance testing.
Is it ready for production?
Until version 1.0, the public API may change between minor versions, and the changes are listed in the changelog and the migration guide. Supported versions says which version receives security fixes.
What do I need to run it?
A server, its worker and PostgreSQL, started by one compose file, plus a key management service: yours, or the sodium backend with a key generated once into a file. The image ships PHP 8.5. Deployment guide.
How is it distributed?
As a Docker image, and a compose file that starts the provider, its worker and PostgreSQL, or from the source of the application, on your own PHP 8.4 runtime and web server. It is an application, not a Symfony bundle. Installation guide.
Does it support FAPI 2.0, DPoP, mTLS, PAR, JAR and CIBA?
Yes. Beffroi OP implements FAPI 2.0, Security Profile and Message Signing, with DPoP and mTLS, and FAPI-CIBA, and the conformance suites for them run every week. FAPI 2.0 on the features page.
Which key management services does it work with?
Beffroi seals its keys through Symfony's KeyManagement component, and the image ships the bridges of HashiCorp Vault and AWS KMS. OpenBao exposes the API of HashiCorp Vault. Without any of them, the sodium backend seals the keys of the tenant with a 32-byte key generated once into a file.
Is PHP a sound choice for an identity provider?
Yes. The security of a provider comes from how it is built, not from its language: Beffroi accepts PKCE in S256 only, serves no implicit or password grant, matches redirect addresses exactly, encrypts personal data at rest and seals its signing keys in your KMS, with no global insecure mode. PHP then fits the job: FrankenPHP boots the application once and keeps it in memory, the code is not compiled and the image is built from the repository with locked dependencies, so what your security team reads is what runs, and it is extended through PHP interfaces and debugged with the tools your team already uses.
Who is behind it?
Beffroi was created by two members of the Symfony core team, specialists in security, authentication and authorization. They contributed OpenID Connect login to Symfony 8.2, and one of them maintains the PHP libraries for WebAuthn, JOSE and OTP that Beffroi rests on. The code is released under the MIT licence. About the project.
Is there a hosted version?
Beffroi is software you run on your infrastructure. A hosted version, with a control plane to manage keys and federation, is on the roadmap. Leave your email to be notified when it ships.
I come from another provider. What can I keep?
The subject identifiers your clients already know, with beffroi:user:create --subject, and the old provider itself, kept upstream over SAML while users move. A user who had a password registers a passkey from an enrolment ticket you hand them. A Keycloak import is on the roadmap. Coming from another provider.
Does it work with Laravel?
Yes, in our tests. Laravel 13 with Socialite and the community socialiteproviders/openidconnect driver completed the code flow with PKCE against Beffroi OP: sign-in, UserInfo claims, ID token signature check, token refresh and logout. Socialite has no generic OpenID Connect driver of its own, so that package is needed, and the client is registered with client_secret_basic.
Does it call anything outside my network?
It calls what you configure and nothing else, and the list is public: every outbound connection, and how to run with no route to the internet.
What does Beffroi refuse to do?
The implicit and password grants, PKCE in plain, patterns in redirect addresses, and any global switch that turns a protection off. Secure defaults.

Did not find your answer?

Features