Oauth Server URL change

[RudiThoeni]

Hi @stefanodavid we changed the primary AuthenticationServer URL from https://auth.opendatahub.bz.it TO https://auth.opendatahub.com

Please update the docs, thx + cheers Rudi

[stefanodavid]

hi @RudiThoeni I am fixing these URLS within #262.

There are however failures in URLs:

• https://tourism.opendatahub.com/
• https://tourism.api.opendatahub.bz.it/v1TourismAssociationReduced?language=iturismusverein (and in general with any URL starting with https://tourism.api.opendatahub.bz.it/v1

Can you tell me how to replace them? Thank you in advance!

[RudiThoeni]

Hi Stefano

If we are speaking about the api let's use https://tourism.api.opendatahub.com

If we are speaking about browsing the data let's use https://tourism.databrowser.opendatahub.com

The TourismAssociationReduced can be removed this are deprecated Api calls

I have not understand what you mean with failures of (and in general with any URL starting with https://tourism.api.opendatahub.bz.it/v1)..... this url works?

[stefanodavid]

Hi @RudiThoeni

What I meant is that we have in the docs many direct URLs to Tourism's API of the form

https://tourism.api.opendatahub.com/v1/Gastronomy?categorycodefilter=33 https://tourism.api.opendatahub.com/v1/MunicipalityReduced?language=it

I was able to fix most of the URLs, but the following two are still broken and are marked as suck by make linkcheck:

[broken] https://tourism.api.opendatahub.com//token: 404 Client Error: Not Found for url: https://tourism.api.opendatahub.com//token [1] [broken] https://tourism.api.opendatahub.com/v1/RegionReduced?language=it: 404 Client Error: Not Found for url: https://tourism.api.opendatahub.com/v1/RegionReduced?language=it [2]

[1] https://docs.opendatahub.com/en/latest/howto/generic/postman.html#getting-a-new-authorisation-token [2] https://docs.opendatahub.com/en/latest/howto/tourism/tips.html#example-calls

I will remove them unless you can suggest an alternative.

[RudiThoeni]

Hi Stefano

The two broken links does not exist anymore and are not used so as you suggest removing is the best solution

cheers Rudi

[stefanodavid]

Hi @RudiThoeni thank you, but there is a problem with the first link, which is contained in a howto that explains how to use the Postman IDE. If you are using Postman and need an authentication token, you need to provide an URL to receive that token. How can you proceed without that link?

[RudiThoeni]

Hi @stefanodavid I fear we have some outdated sections in the docs....

The only valid method now to authenticate is by using Keycloak, all other Authentication are deprecated and not used anymore The token from Keycloak is then sent to the api as Bearer token, both on mobility and tourism the same procedure

As described here https://opendatahub.readthedocs.io/en/latest/guidelines/authentication.html#authentication-hub Here also a little wiki page about the authorization (https://github.com/noi-techpark/odh-docs/wiki/How-do-I-get-an-authorization-token-for-API%3F)

[stefanodavid]

The whole documentation for developers is being removed in #279, which therefore supersedes this issue