Tack vare uppdateringar i ArcGIS Pro och Lantmäteriets API-portal stöds nu autentisering och behörighetskontroll genom OAuth för de OGC API och WMS på vilka Lantmäteriet har valt att erbjuda OAuth som autentiseringsmetod. Från tidigare stöds Basic Auth. I det här inlägget får du veta hur du kommer i gång, steg för steg. Instruktionerna fungerar för ArcGIS Pro 3.5.3.
Lantmäteriet erbjuder autentisering och behörighetskontroll på sina tjänster genom två olika metoder: Basic Auth och OAuth. Basic Auth är enklare att använda men mindre säkert då det kräver att användarnamn och lösenord skickas vid varje förfrågan till tjänsten. OAuth är lite svårare att sätta upp men ger en bättre användarupplevelse och säkerhet, eftersom det tillåter autentisering hos tredje part utan att dela lösenord direkt. Man kan läsa om hur man använder OAuth i ArcGIS Pro här: Connect to authentication providers from ArcGIS Pro.
I detta blogginlägg använder jag Lantmäteriets OGC API Hydrografi Direkt som exempel.
Steg 1: Skapa en applikation för ArcGIS Pro i API-portalen
I Lantmäteriets API-portal behöver följande steg utföras (logga in med det Lantmäteriet systemkonto du skall använda för att konsumera Lantmäteriets OGC API eller WMS). Du kan läsa mera om hur man använder API-portalen i Lantmäteriets dokumentation.
a) Skapa en ny applikation i API-portalen.
b) Gå till fliken Application Keys, välj Grant Types enligt bilden nedan och ange arcgis-pro://auth som Callback URL.
c) Kryssa i Enable PKCE och Public client, klicka sedan på GENERATE KEYS. Nu skapas en Consumer Key som visas högst upp på sidan. Du behöver den i nästa steg.
d) Gå till fliken Subscriptions, välj SUBSCRIBE APIS och leta reda på rätt API (se Lantmäteriets Dokumentation geodataprodukter för vilket API som gäller, för Hydrografi Direkt är det OGC-Features – v1) och klicka på SUBSCRIBE. Då du är klar skall det se ut som i bilden nedan.
Steg 2: Skapa en autentiseringsanslutning i ArcGIS Pro
För att från ArcGIS Pro ansluta med OAuth behöver man först skapa en autentiseringsanslutning.
a) Från fliken Project, välj Options > Authentication > Add Connection.
b) Ange ett namn och fyll i följande uppgifter:
- Type: Custom
- Authorization URL: https://apimanager.lantmateriet.se/oauth2/authorize
- Token URL: https://apimanager.lantmateriet.se/oauth2/token
- Client ID: ange den Consumer Key som du skapade i API-portalen
- Scopes: för Hydrografi direkt skall man ange ogc-features:hydrografi.read (se API-portalens dokumentation för vad som gäller angående scope).
c) Klicka OK.
d) Testa att allt fungerar genom att klicka på de tre punkterna och välja Sign in.
e) Du förflyttas då till din webbläsare där du loggar in med ditt Lantmäteriet systemkonto. Tillåt sedan det begärt scope och ge tillstånd för webbsidan att öppna ArcGIS Pro. Om du lyckats skall det stå Signed in där det tidigare stod Not signed in.
Autentiseringsanslutningar i ArcGIS Pro är baserade på OAuth 2.0. När du loggar in på en anslutning omdirigeras du till leverantörens inloggningssida, där du anger dina inloggningsuppgifter och ger ArcGIS Pro (tredje part i det här sammanhanget) åtkomst till resurser. När du väl är inloggad kan du använda autentiseringsanslutningen när du ansluter till tjänster som stöder detta arbetsflöde.
Steg 3: Använd autentiseringsanslutningen
För att ansluta till en WMS eller OGC API behöver du en WMS eller OGC API Server Connection i Pro. Här skapar jag en ny anslutning till tjänsten Hydrografi Direkt.
a) Från fliken Insert, välj Connections > Server > New OGC API Server.
b) Ange följande uppgifter
- Server URL: https://api.lantmateriet.se/ogc-features/v1/hydrografi
- Version: Default version
- Authentication: välj autentiseringsanslutningen du skapade i föregående steg (om du i stället vill ansluta med Basic Auth skall du välja Server Authentication och ange användarnamn och lösenord för ditt Lantmäteriet systemkonto).
c) I katalogpanelen kan du nu lägga till lager från din Server Connection.
Framtida utveckling
Tack vare ett samarbete mellan Esri Sverige, Lantmäteriet och utvecklarteamet bakom ArcGIS Pro kan man nu välja om man vill använda Basic Auth eller OAuth med Lantmäteriets OGC API och WMS som stöder OAuth. Framöver är målsättningen att man även skall kunna använda Lantmäteriets STAC-tjänster med OAuth.
Läs mer om det här: GUIDE: Så använder du Lantmäteriets STAC-tjänster i ArcGIS Pro
