Földrajzi hely és IP-címkezelés

Ez a cikk bemutatja, hogyan működik a földrajzi helykeresés és az IP-címkezelés az Application Insightsban.

Alapértelmezett viselkedés

Alapértelmezés szerint az IP-címeket ideiglenesen gyűjti a rendszer, de nem tárolja őket.

Amikor telemetriát küld az Azure-ba, az IP-címet a rendszer egy földrajzi helykeresésben használja. Az eredmény a mezők és a mezők client_Cityclient_StateOrProvinceclient_CountryOrRegionkitöltésére szolgál. A cím ezután el lesz vetve, és 0.0.0.0 a client_IP mezőbe lesz írva.

A telemetriai típusok a következők:

• Böngészőtelemetria: Az Application Insights összegyűjti a feladó IP-címét. A betöltési végpont kiszámítja az IP-címet.
• Kiszolgálótelemetria: Az Application Insights telemetriai modul ideiglenesen összegyűjti az ügyfél IP-címét, ha a X-Forwarded-For fejléc nincs beállítva. Ha a bejövő IP-címlista több elemet tartalmaz, a rendszer az utolsó IP-címet használja a földrajzi hely mezőinek feltöltéséhez.

Ez a viselkedés a személyes adatok és IP-címek helyadatainak szükségtelen gyűjtésének elkerülésére szolgál.

Ha nem gyűjti össze az IP-címeket, a város és más földrajzi hely attribútumok szintén nem lesznek összegyűjtve.

IP-címadatok tárolása

Figyelmeztetés

Az alapértelmezett és a javaslatunk az, hogy ne gyűjtsünk IP-címeket. Ha felülbírálja ezt a viselkedést, ellenőrizze, hogy a gyűjtemény nem szegi meg a megfelelőségi követelményeket vagy a helyi előírásokat.

A személyes adatok kezelésével kapcsolatos további információkért tekintse meg a személyes adatokkal kapcsolatos útmutatót.

Feljegyzés

Az IP-címek, amelyek a DisableIpMasking tulajdonság engedélyezése előtt betöltött telemetriához kapcsolódnak, továbbra is 0.0.0.0 formában jelennek meg. Csak a módosítás után betöltött telemetriai adatok tükrözik a tényleges IP-címadatokat.

Az IP-gyűjtés és -tárolás engedélyezéséhez az DisableIpMasking Application Insights összetevő tulajdonságának a következőre kell állítania: true.

IP-maszkolás letiltása

Jótanács

Ha csak egyetlen Application Insights-erőforrás viselkedését kell módosítania, használja az Azure Portalt.

Portál

1. Nyissa meg az Application Insights-erőforrást, majd válassza az Automation>Export sablont.

2. Válassza az Üzembe helyezés lehetőséget.

   

3. Válassza a Sablon szerkesztése lehetőséget.

   

   Feljegyzés

   Ha az előző képernyőképen látható hibát tapasztalja, megoldhatja azt. A következőt írja: "Az erőforráscsoport olyan helyen található, amelyet a sablon egy vagy több erőforrása nem támogat. Válasszon másik erőforráscsoportot." Ideiglenesen válasszon ki egy másik erőforráscsoportot a legördülő listából, majd jelölje ki újra az eredeti erőforráscsoportot.

4. A JSON-sablonban keresse meg properties a fájlt.resources Adjon hozzá egy vesszőt az utolsó JSON-mezőhöz, majd adja hozzá a következő új sort: "DisableIpMasking": true. Ezután válassza a Mentés lehetőséget.

   

5. Válassza a Véleményezés + létrehozás lehetőséget>.

   Feljegyzés

   Ha a "Sikertelen üzembe helyezés" szöveget látja, tekintse át a típussal microsoft.insights/components rendelkező példány üzembehelyezési adatait, és ellenőrizze az állapotot. Ha ez sikerül, a módosítások DisableIpMasking üzembe lettek helyezve.

6. Az üzembe helyezés befejezése után a rendszer új telemetriai adatokat rögzít.

   Ha ismét kijelöli és szerkessze a sablont, csak az újonnan hozzáadott tulajdonság nélküli alapértelmezett sablont. Ha nem látja az IP-címadatokat, és ellenőrizni szeretné, hogy be van-e "DisableIpMasking": true állítva, futtassa a következő PowerShell-parancsokat:

   # Replace <application-insights-resource-name> and <resource-group-name> with the appropriate resource and resource group name.
   
   # If you aren't using Azure Cloud Shell, you need to connect to your Azure account
   # Connect-AzAccount
   
   $AppInsights = Get-AzResource -Name '<application-insights-resource-name>' -ResourceType 'microsoft.insights/components' -ResourceGroupName '<resource-group-name>'
   $AppInsights.Properties
   

   Ennek eredményeként a függvény visszaadja a tulajdonságok listáját. Az egyik tulajdonságnak olvasnia DisableIpMasking: truekell. Ha az új tulajdonság Azure Resource Managerrel való üzembe helyezése előtt futtatja a PowerShell-parancsokat, a tulajdonság nem létezik.

Azure CLI

Feljegyzés

Az Azure jelenleg nem biztosít módot az Application Insights IP-maszkolásának letiltására az Azure CLI-vel. Az IP-maszkolás programozott letiltásához használja az Azure PowerShellt.

PowerShell

Ha le szeretné tiltani az IP-maszkolást az Azure PowerShell használatával, használja a következő parancsot, és cserélje le a helyőrzőket <application-insights-resource-name> és <resource-group-name> a megadott értékeket:

Update-AzApplicationInsights -Name "<application-insights-resource-name>" -ResourceGroupName "<resource-group-name>" -DisableIPMasking:$true

A parancsmaggal kapcsolatos további információkért Update-AzApplicationInsights tekintse meg az Azure PowerShell dokumentációját.

REST API

Ha le szeretné tiltani az IP-maszkolást a REST API-val, használja a következő kérést, és cserélje le a helyőrzőket <subscription-id>, <resource-group-name>, <application-insights-resource-name>és <access-token><azure-region-name> a megadott értékeket:

PATCH https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>?api-version=2018-05-01-preview HTTP/1.1
Host: management.azure.com
Authorization: Bearer <access-token>
Content-Type: application/json

{
    "location": "<azure-region-name>",
    "kind": "web",
    "properties": {
        "Application_Type": "web",
        "DisableIpMasking": true
    }
}

Az Application Insights-erőforrások REST API-val való konfigurálásáról további információt a REST API dokumentációjában talál.

Bicepsz

Ha le szeretné tiltani az IP-maszkolást a Bicep használatával, használja az alábbi sablont, és cserélje le a helyőrzőket <application-insights-resource-name> és <azure-region-name> a megadott értékekre:

resource appInsights 'microsoft.insights/components@2020-02-02' = {
    name: '<application-insights-resource-name>'
    location: '<azure-region-name>'

    kind: 'web'
    properties: {
        Application_Type: 'web'
        DisableIpMasking: true
    }
}

ARM (JSON)

Ha le szeretné tiltani az IP-maszkolást az ARM (JSON) használatával, használja az alábbi sablont, és cserélje le a helyőrzőket <subscription-id>, <resource-group-name><application-insights-resource-name>és <azure-region-name> a megadott értékeket:

{
    "id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>",
    "name": "<application-insights-resource-name>",
    "type": "microsoft.insights/components",
    "location": "<azure-region-name>",

    "kind": "web",
    "properties": {
        "Application_Type": "web",
        "DisableIpMasking": true
    }
}

Következő lépések

• További információ a személyes adatgyűjtésről az Azure Monitorban.
• Megtudhatja, hogyan állíthatja be a felhasználói IP-címet az OpenTelemetry használatával.