REST API Reference on Docker Container

[rackrick]

Hi there,

I setup a EJBCA Instance using the docker container. Now I want to use the rest api the issue some certs.
To do that I was looking for a API reference but the one mentioned in the documentation returns a 404 not found.

https://doc.primekey.com/ejbca/ejbca-operations/ejbca-ca-concept-guide/protocols/ejbca-rest-interface#EJBCARESTInterface-RESTAPIReferencerest_api_reference

I found an old post with the same issue but no answer:
#177

Is there any way to get the api reference without the need to setup a instance without docker or to do a build without the prod flag?

[primetomas]

You mean this URL right? https://localhost:8442/ejbca/doc/rest

[rackrick]

correct...
since its a docker container I can't use localhost and tried the ip instead.
Also I noticed the port in the screenshot differs from the one mentioned in the documentation. So I assumed 8443 would be correct.

[primetomas]

You can download swagger.json from GitHub: https://github.com/Keyfactor/ejbca-ce/blob/main/modules/ejbca-rest-api/resources/swagger.json

Then you can run swagger locally by for exampel:
docker run -p 80:8080 -e SWAGGER_JSON=/foo/swagger.json -v /tmp:/foo swaggerapi/swagger-ui

That gives you Swagger API.

[rackrick]

Thanks for your help... I didn't thinkt about the swagger.json. That helps... you can even open it on https://editor.swagger.io/ to keep it simple without the container.

[primetomas]

Ah, thanks for that. I'll add a note about this in the documentation for the next release.