Používání autentizace založené na API klíči s GeoAnalytics for Fabric

DerekGourley

Bezpečnost a správa pro autorizované uživatele jsou důležité při řízení vašeho analytického prostředí. Abychom s tím pomohli, ArcGIS GeoAnalytics for Fabric zahrnuje možnost vytvářet (a mazat) API klíče pro poskytování přístupu uživatelům napříč vaší organizací. To umožňuje použít API klíč místo uživatelského jména a hesla. Díky API klíčům může být jedna předplatná GeoAnalytics for Fabric snadno spravována pro kontrolu přístupu uživatelů sdílením, odvoláváním a rotací API klíčů podle potřeby. V tomto blogovém příspěvku projdeme kroky potřebné k vytvoření a použití metody autorizace pomocí API klíče.<\/P>

Všimněte si, že i když API klíče samy o sobě nabízejí určitou úroveň bezpečnosti a kontroly, doporučujeme zajištění a přístup k těmto údajům pomocí Azure Key Vault nebo podobného mechanismu pro ukládání a správu tajemství.<\/P>

Vytvoření API klíče<\/EM><\/STRONG><\/P>API klíče GeoAnalytics for Fabric se vytvářejí pomocí GeoAnalytics for Fabric dashboardu spojeného s účtem. V této části popíšeme kroky k vytvoření API klíče.<\/P>Poznámka:<\/STRONG> Doporučujeme konzultovat s vašimi bezpečnostními\/IT týmy a řídit se jejich politikami a pokyny ohledně nejlepších postupů pro ukládání a používání API klíčů pro GeoAnalytics for Fabric.

<\/P>Vyberte záložku „Developer credentials“ a klikněte na tlačítko „New developer credentials“.<\/span> <\/P><\/LI>Zobrazí se vyskakovací okno "Create developer credentials". V tomto okně nastavte datum vypršení platnosti a poté klikněte na tlačítko „next“.
<\/span> <\/P><\/LI>Pojmenujte API klíč jedinečným názvem (např. podle uživatele nebo skupiny, které bude API klíč přiřazen) a volitelně vyplňte další nastavení, poté klikněte na tlačítko „next“.
<\/span><\/LI>Zkontrolujte nastavení API klíče před vygenerováním údajů a poté klikněte na tlačítko "next".<\/LI>Bude nabídnuta možnost vygenerovat API klíč nyní nebo později. Vyberte možnost a klikněte na tlačítko "next".<\/P>Poznámka:<\/STRONG> Jakmile je API klíč vygenerován, musí být okamžitě zkopírován na bezpečné místo, protože není uložen pro budoucí přístup. Dodržování nejlepších bezpečnostních praktik pro API klíče pomůže udržet API klíč v bezpečí.  

<\/P><\/span> <\/P><\/LI>Pokud byla vybrána možnost vygenerovat API klíč „nyní“, zobrazí se API klíč v novém vyskakovacím okně. Tento API klíč slouží k autorizaci GeoAnalytics for Fabric. Jak bylo uvedeno ve kroku 5 výše, dodržování nejlepších bezpečnostních praktik pomůže udržet API klíč v bezpečí.

<\/span><\/LI><\/OL>Autentizace GeoAnalytics for Fabric pomocí API klíče<\/EM><\/STRONG><\/P>Pro autorizaci GeoAnalytics for Fabric nejprve importujte modul „geoanalytics_fabric“. Poté použijte API klíč, který byl v předchozím kroku vygenerován, nebo použijte existující API klíč, a předáte jej jako řetězcovou hodnotu do parametru „api_key“ funkce authorization GeoAnalytics for Fabric.import geoanalytics_fabric geoanalytics_fabric.auth(api_key=":API key goes here:") <\/P>Může být také použit systém správy tajemství k pomoci udržet API klíč v bezpečí (viditelně redigovaný) a může být použit k přímému předání řetězce API klíče do parametru api_key.<\/P>Pro ověření, že GeoAnalytics for Fabric byla úspěšně autorizována, použijte geoanalytics_fabric.auth_info()<\/_a>

geoanalytics_fabric.auth_info().show()

Pokud je autorizace úspěšná, vrátí se tabulka obsahující informace o autorizaci GeoAnalytics for Fabric. Při použití API klíče bude hodnota řádku "auth" "token/apikey". Pro demonstrační účely byly ostatní hodnoty řádků, které by normálně byly vráceny v tabulce, ponechány prázdné.<\/_p>

Pokud je API klíč neplatný nebo deaktivovaný, funkce autorizace GeoAnalytics for Fabric vrátí chybu „not authorized“ a vrácená tabulka "auth_info" bude prázdná.

Pro další ověření, že GeoAnalytics for Fabric funguje správně, můžete spustit následující ukázkový kód níže.

# Imports
from geoanalytics_fabric.sql import functions as ST, Point

# Vytvoření DataFrame
data = [
    (1, Point(2279074.576461232, 103019.15556246601)),
    (2, Point(2278748.209109826, 103521.65548041835)),
    (3, Point(2279243.741068326, 103250.88697086088))
]
df = spark.createDataFrame(data, [\'id\', \'point\']) \\
          .withColumn(\'point\', ST.srid(\'point\', 6558))
df.printSchema()
df.show(truncate=False)

# Zobrazení DataFrame 
df_plot = df.st.plot(basemap=\'light\', xmargin=0.15, ymargin=0.3, figsize=(10,10));
df_plot.set_title(\'Oregon State University body zájmu\')
df_plot.set_xlabel(\'X (metry)\')
df_plot.set_ylabel(\'Y (metry)\');

 

Závěr

 

V tomto blogovém příspěvku jsme se podívali na to, jak může být GeoAnalytics for Fabric autorizována pomocí metody API klíče. Doufejme, že tento příspěvek byl užitečný při začátcích používání této metody autorizace pro vaše analytické pracovní postupy. Pokud máte jakékoli dotazy ohledně této metody autorizace nebo jakýchkoli dalších nástrojů GeoAnalytics for Fabric, SQL funkcí, nebo sledovacích funkcí, neváhejte poskytnout zpětnou vazbu nebo položit otázky v sekci komentářů níže.