API Documentation

[dannyyy]

I'm hosting Hanko in my home lab for the purpose of having a passkey enabled OIDC provider.

But after a rather hard setup process where no proper documentation is provided (need to consult dozens of pages and issues to get all the details), the usage of it is in my point of view inexistant.
Is this just a personal opinion or intended to push towards your cloud solution?

I cannot find any proper API documentation, neither for the public API nor admin API. The one found in the official docs is not compatible. I assume, it's for the commercial cloud version.

There are very basic questions like

• Where to get the credentials for the OIDC setup (client_id, ...)
• Do I need a token / secret to communicate wuth the admin API? Since I don't know a single endpoint, all I get is 404
• How to register a first (admin) user? Is there a concept of users of different privileges?
• How can I register one or multiple passkeys to that user? I want to use the IdP with Passkey only. Any common tool like curl, Postman, ... is okay for me
• Is it possible to assign certain claims to a user?

I would really appreciate if someone could point me to the documentation or help me out with other resources.

In a second project I am already using the cloud version, but my gut feeling says, be cautious.