please update getting started documentation

[BMaxV]

Hello,

I basically wanted to update some old xml code to esi, but the old code never needed authentification and I am not sure how to do 0auth from something that isn't a webserver.

I found:

https://developers.eveonline.com/blog/article/sso-to-authenticated-calls
https://developers.eveonline.com/blog/article/swagger-codegen

Both of which basically no longer work. One has mention of some python module that can't be downloaded because there is no link and the other one... could be simpler.

I found this:

https://github.com/bastianh/flask-eve-sso-example

which works so-so. When you run it, it works, but it uses the 'flask-0auth' module, which the 'flask-0auth' documentation says you no longer should do. But people should use 'authlib' instead:

https://docs.authlib.org/en/latest/

and I'm not sure how ESI and that fit together anymore.

I understand the general idea how it is supposed to work, but I'm not sure which variable names are supposed to go where to do what kind of access.

For example the eve esi tutorial mentions a redirect callback url and the 0auth documentation doesn't.

So... 'LittErALy UnUsuAble'. Please Help :P

[Blacksmoke16]

but the old code never needed authentication

If the ESI equivilent is public, you wouldn't have to do SSO. However if the XML version requires an API key, then you'll have to set something up.

https://docs.esi.evetech.net/

Would be the current docs.

[BMaxV]

Thank you! Those docs are newer and probably better than the old ones. They don't really solve my problems though. For example:

https://docs.esi.evetech.net/docs/sso/native_sso_flow.html

Still assumes I know how to redirect from a standalone application to a browser and back on my end.

I understand the steps described in the esi docs, but I have no idea how they connect with what I find in the docs for authlib:

https://docs.authlib.org/en/latest/
https://docs.authlib.org/en/latest/client/flask.html

In the later link, the first that apparently "needs" to be done is registering. Is this the thing I do on the developers.eveonline website when I create the name, secret(?) and redirect url? Or is this some other registration? Where is the redirect url in the authlib config?

[lukasni]

The docs are open source, you can find the repository in esi/esi-docs. Anyone who notices issues with them is welcome to submit pull requests.

The docs also canno teach you how to use your specific library, so there's always some external research that has to be done. That said, some of the auth docs could definitely use some love, maybe open up an issue on that repo if you notice any specific omissions.