Met de Play Integrity API kun je je apps en games beschermen tegen riskante interacties. Door deze acties op te sporen, kan de app op de juiste manier het risico op aanvallen en misbruik beperken.
Hoe het werkt
De Integrity API combineert de antimisbruikfuncties van Google Play met een aantal integriteitssignalen. Zo kunnen ontwikkelaars van Android-apps en -games mogelijk riskant en frauduleus verkeer makkelijker opsporen. Dit verkeer kan afkomstig zijn van aangepaste versies van je app of game, of van onbetrouwbare apparaten of omgevingen. Als je dit verkeer laat opsporen, kun je de juiste acties ondernemen om aanvallen en misbruik zoals bedrog, valsspelen en onbevoegde toegang te beperken.
Als een gebruiker een voor de app of game gedefinieerde actie uitvoert, krijgt de code aan de clientzijde van je server opdracht om de Integrity API aan te roepen. De Google Play-server retourneert een versleutelde reactie met een integriteitsbeoordeling over de betrouwbaarheid van dit apparaat en het bijbehorende binaire bestand. Daarna stuurt de app deze reactie naar je server voor verificatie. De server kan bepalen wat je app of game hierna moet doen.
De API levert een integriteitsbeoordeling in een reactie met de volgende informatie:
- Echt binair bestand van app: Bepaal of je interactie hebt met je niet-aangepaste binaire bestand, zoals herkend door Google Play.
- Echte Play-installatie: Bepaal of het huidige gebruikersaccount een licentie heeft. Dit betekent dat de gebruiker je app of game heeft geïnstalleerd of betaald via Google Play.
- Echt Android-apparaat: Bepaal of je app wordt uitgevoerd op een echt Android-apparaat met Google Play-services (of een echte instantie van Google Play Games voor de pc).
Je kunt er ook voor kiezen aanvullende informatie over de omgeving te krijgen in de integriteitsbeoordeling:
- Risico door app-toegang: Bepaal of er andere apps worden uitgevoerd die het scherm kunnen vastleggen, overlays over je app kunnen tonen of het apparaat kunnen bedienen.
- Risico door bekende malware: Bepaal of Google Play Protect aanstaat en of er bekende malware op het apparaat is gevonden.
Tips:
- Je kunt de status van de Play Integrity API en andere Play-services in de gaten houden via het Google Play-statusdashboard.
- De Integrity API is het waardevolst voor je app als je alle aanbevolen procedures volgt in de documentatie op de site Android voor ontwikkelaars.
De Play Integrity API instellen en beheren
De Integrity API aanzetten voor je app
Als je Integrity API-reacties wilt aanzetten voor je app, moet je een Google Cloud-project koppelen in de Play Console. Zo koppel je je project:
- Open de Play Console en ga naar de pagina App-integriteit (Testen en releasen > App-integriteit).
- Scroll naar het gedeelte Play Integrity API.
- Kies Bestaand project koppelen en het project waaraan je wilt koppelen.
- Klik op Cloudproject koppelen.
Doe het volgende om de Integrity API in je app te integreren:
- Voor Java/Kotlin-apps installeer je de nieuwste beschikbare Android-bibliotheek voor de Play Integrity API vanuit de Maven-repository van Google.
- Installeer voor Unity-games de nieuwste release van Google Play-plug-ins voor Unity. Alle versies van 2019.x, 2020.x en hoger worden ondersteund. Als je Unity 2018.x gebruikt, moet je 2018.4 of hoger installeren. Als je Unity 2017.x gebruikt, moet je 2017.4.40 of hoger installeren. Unity 5.x en lager worden niet ondersteund.
- Installeer voor systeemeigen apps en games de nieuwste Play Core Native SDK.
Volg deze stappen op de site voor Android-ontwikkelaars om de Play Integrity API in je app of game te gebruiken.
(Optioneel) Integrity API-reacties aanpassen
Ga naar de site voor Android-ontwikkelaars voor meer informatie over hoe je API-integriteitsreacties instelt.
Zo bewerk je je API-reacties:
- Open de Play Console en ga naar de pagina App-integriteit (Testen en releasen > App-integriteit).
- Scroll naar het gedeelte Play Integrity API.
- Klik op Instellingen.
- Scroll naar het gedeelte Reacties.
- Klik op Bewerken.
- Vink de selectievakjes aan of verwijder de vinkjes naast de API-reacties die je wilt wijzigen.
- Klik op Wijzigingen opslaan.
Belangrijk: De wijzigingen in API-reacties worden meteen van kracht nadat je ze hebt opgeslagen, ook als je app in productie is. Voordat je de set API-reacties in je Play Console wijzigt, moet je zorgen dat je server klaar is om die reacties te accepteren.
(Optioneel) Instellingen voor klassieke verzoeken instellen
Standaard beheert Google je reactieversleuteling voor klassieke verzoeken. Als je wilt, kun je je reactieversleuteling ook zelf beheren.
Belangrijk: Als je wisselt tussen reactieversleuteling die wordt beheerd door Google en reactieversleuteling die je zelf beheert, moet je de code op je backend-server wijzigen.
Zo beheer je zelf je reactieversleuteling:
- Open de Play Console en ga naar de pagina App-integriteit (Testen en releasen > App-integriteit).
- Scroll naar het gedeelte Play Integrity API.
- Klik op Instellingen.
- Scroll naar het gedeelte Klassieke verzoeken. De status naast Reactieversleuteling is standaard Beheerd door Google. Klik op Wijzigen.
- Kies Mijn sleutels voor reactieversleuteling beheren en downloaden. Google maakt sleutels voor reactieversleuteling die je kunt downloaden en beheren. Je moet de logica van je backend-server updaten zodat de sleutels worden gebruikt om reacties te ontsleutelen.
- Volg de instructies op het scherm om een pem-bestand te maken en upload het pem-bestand om je API-sleutels te downloaden.
- Klik op Wijzigingen opslaan.
- Je krijgt een bericht op het scherm dat het beheer van je reactieversleuteling is geüpdatet.
- Je nieuwe sleutels voor reactieversleuteling worden automatisch gedownload. Je kunt ze later altijd downloaden door op Sleutels downloaden te klikken.
Als je zelfbeheerde sleutels weer door Google wilt laten beheren:
- Open de Play Console en ga naar de pagina App-integriteit (Testen en releasen > App-integriteit).
- Scroll naar het gedeelte Play Integrity API.
- Klik op Instellingen.
- Scroll naar het gedeelte Klassieke verzoeken. De status naast Reactieversleuteling is Zelfbeheerd, omdat je deze in het verleden hebt gewijzigd. Klik op Bewerken.
- Kies 'Google mijn reactieversleuteling laten beheren (aanbevolen)' en klik op Wijzigingen opslaan. Google genereert en beheert je sleutels voor reactieversleuteling. Je backend-server moet de Google Play-server aanroepen om reacties te ontsleutelen.
De integratie van je Play Integrity API testen
Als je de integratie van de Integrity API wilt testen, stel je een lijst met Gmail-accounts in. Zorg eerst dat je testers toegang hebben tot je release. Publiceer je app op de interne testtrack of de track waarop je de test wilt uitvoeren. Volg daarna de instructies voor het beheer van testers op basis van e-mailadres of via Google Groepen, zodat je testers toegang krijgen tot je release.
Zo stel je een test in:
- Open de Play Console en ga naar de pagina App-integriteit (Testen en releasen > App-integriteit).
- Scroll naar het gedeelte Play Integrity API.
- Klik op Instellingen.
- Scroll naar het gedeelte Testen.
- Klik op Nieuwe test maken.
- Selecteer een mailinglijst of maak een nieuwe.
- Klik op Test maken.
Je winkelvermelding aanpassen als gebruikers je site bezoeken via Integrity API-dialoogvensters
Je kunt een hersteldialoogvenster van de Integrity API gebruiken om gebruikers die je app onofficieel hebben verkregen, te vragen je app te downloaden via Google Play. Als gebruikers op het dialoogvenster tikken, worden ze omgeleid naar je winkelvermelding. Hier kunnen ze op de knop Installeren (of Kopen of Updaten) tikken zodat de app wordt toegevoegd aan de Play-bibliotheek van de gebruiker.
Je kunt de items in je winkelvermelding aanpassen voor bezoekers die op hersteldialoogvensters van de Integrity API tikken, waaronder de naam, het icoon, de beschrijvingen en grafische items van je app. Zo pas je de winkelvermelding aan als gebruikers je site bezoeken via een Integrity API-dialoogvenster:
- Open de Play Console en ga naar de pagina App-integriteit (Testen en releasen > App-integriteit).
- Scroll naar het gedeelte Play Integrity API.
- Klik op Instellingen.
- Scroll naar het gedeelte Winkelvermelding aanpassen.
- Klik op Vermelding maken.
- Volg de instructies op de pagina Aangepaste winkelvermelding maken en klik op Opslaan.
Je kunt aangepaste winkelvermeldingen voor Integrity API-dialoogvensters ook rechtstreeks op de pagina Aangepaste winkelvermeldingen maken:
- Open de Play Console en ga naar de pagina Aangepaste winkelvermeldingen (Aantal gebruikers vergroten > Aangepaste winkelvermeldingen).
- Klik op Vermelding maken, kies of je een nieuwe vermelding wilt maken of een bestaande vermelding wilt dupliceren en klik op Volgende.
- Ga onder 'Details van de vermelding' naar het gedeelte Doelgroep.
- Selecteer Via URL en typ 'playintegrity' in het tekstvak.
- Vul alle andere gegevens in en klik op Opslaan.
Tip: De URL-parameter playintegrity is een speciaal zoekwoord dat is gereserveerd voor deep links voor integriteit. Je moet deze dus exact invoeren als je de aangepaste winkelvermelding instelt.
Je dagelijkse maximale aantal verzoeken voor de Play Integrity API verhogen
Apps kunnen standaard maximaal 10.000 verzoeken per dag naar de Integrity API sturen.
Zo bekijk je het aantal verzoeken dat je app dagelijks stuurt:
- Open de Play Console en ga naar de pagina App-integriteit (Testen en releasen > App-integriteit).
- Scroll naar het gedeelte Play Integrity API.
- Bekijk je dagelijkse aantal verzoeken. Klik op Integrity API-rapport bekijken om meer gegevens te bekijken, de periode te wijzigen en filters toe te passen.
Zo bekijk je het dagelijkse maximumaantal verzoeken voor je app:
- Open de Play Console en ga naar de pagina App-integriteit (Testen en releasen > App-integriteit).
- Scroll naar het gedeelte Play Integrity API.
- Klik op Instellingen.
- Bekijk je gebruiksniveau.
Je kunt een verzoek indienen om meer dan 10.000 verzoeken per dag in te dienen. Je moet aan de volgende vereisten voldoen om in aanmerking te komen:
- Controleer of de API-logica goed wordt geïmplementeerd, waaronder nieuwe pogingen.
- Publiceer je app op Google Play en eventuele andere distributiekanalen.
Als je het maximale aantal dagelijkse verzoeken wilt verhogen, vul je dit formulier in.
Gerelateerde content
- Lees de documentatie voor ontwikkelaars voor de Play Integrity API.
- Bekijk deze overzichtsvideo over de Play Integrity API.
- Kom meer te weten over integriteits- en ondertekeningsservices in de Play Console.
- Kom meer te weten over integriteits- en ondertekeningsservices op de site voor Android-ontwikkelaars.