Document new API in OCP\Authentication

[come-nc]

☑️ Resolves

• Document Move IToken and IProvider::getToken to OCP server#41017

🖼️ Screenshots

[ChristophWurst]

New APIs should have a persistent place, e.g. somewhere we already have docs about authentication.

The upgrade docs purpose is to help maintains of existing apps keep their app alive for the next major. They only need to know about stuff that was changed or removed.

In other words, someone potentially developing against this new API will have a hard time finding docs.

Hope this makes sense.

[come-nc]

New APIs should have a persistent place, e.g. somewhere we already have docs about authentication.

The upgrade docs purpose is to help maintains of existing apps keep their app alive for the next major. They only need to know about stuff that was changed or removed.

In other words, someone potentially developing against this new API will have a hard time finding docs.

Hope this makes sense.

In https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/security.html ?

Most of OCP is not documented outside of https://nextcloud-server.netlify.app, which already lists https://nextcloud-server.netlify.app/classes/ocp-authentication-token-iprovider and https://nextcloud-server.netlify.app/classes/ocp-authentication-token-itoken

[ChristophWurst]

In https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/security.html ?

Sounds good!

The current state is not great, yeah. We have to start somewhere …

[come-nc]

/backport to stable28

[come-nc]

Merging this as it’s still better than nothing and #11283 will conflict if merged first.

[AndyScherzinger]

@come-nc I created a separate ticket to docuemnt the newly added APIs on a to-be created dev manual page, see #11352