Play Integrity APIlla voit suojata sovelluksia ja pelejä vaaralliselta toiminnalta. Havaitessaan hyökkäykset ja väärinkäytön sovelluksesi voi reagoida asiaankuuluvasti, ja tällaisen toiminnan riski pienenee.
Näin se toimii
Integrity API yhdistää Google Playn väärinkäyttöä ehkäisevät ominaisuudet eheyssignaalien avulla. Näin Android-sovellusten ja ‑pelien kehittäjät voivat tunnistaa mahdollisesti vaarallisen ja vilpillisen liikenteen. Liikenne voi olla peräisin sovelluksesi tai pelisi muokatuista versioista, epäluotettavista laitteista tai muista epäluotettavista ympäristöistä. Havaitsemalla tämän liikenteen voit reagoida siihen ja vähentää hyökkäyksiä ja väärinkäyttöä, kuten petoksia, huijaamista ja luvatonta käyttöä.
Kun käyttäjä suorittaa sovelluksen tai pelin määrittämän toiminnon, palvelin ohjaa asiakaspuolen koodin käynnistämään Integrity APIn. Google Play ‐palvelin palauttaa salatussa vastauksessa eheyslausunnon, joka kertoo, voitko luottaa laitteeseen ja sen binaariin. Seuraavaksi sovellus välittää vastauksen palvelimellesi vahvistusta varten. Palvelin voi päättää, mitä sovelluksen tai pelin pitäisi tehdä seuraavaksi.
API antaa eheyslausunnon vastauksessa, joka sisältää seuraavat tiedot:
- Aidot sovellusbinaarit: Selvitä, toimitko Google Playn tunnistaman muokkaamattoman binaarin kanssa.
- Aito Play-asennus: Selvitä, onko nykyinen käyttäjätili lisensoitu, eli onko käyttäjä asentanut sovelluksesi tai pelisi tai maksanut siitä Google Playssa.
- Aito Android-laite: Selvitä, onko sovelluksesi käytössä aidolla, Google Playn tarjoamalla Android-laitteella (tai aidolla Google Play Pelit tietokoneille ‐ohjelmalla).
- Ei tunnettuja haittaohjelmia: Tarkista, onko Google Play Protect päällä ja onko se löytänyt laitteelle asennettuja riskialttiita tai vaarallisia sovelluksia.
Vinkkejä:
- Voit seurata Play Integrity APIn ja muiden Play-palveluiden tilaa Google Playn tilapaneelista.
- Sovellus saa Integrity APIsta parhaimman hyödyn, kun seuraat kaikkia Android-kehittäjien sivuston dokumentaatiossa olevia suosituksia.
Play Integrity APIn käyttöönotto ja ylläpito
Integrity APIn käyttöönotto sovelluksellesi
Jos haluat ottaa Integrity APIn vastaukset käyttöön sovelluksessasi, sinun on linkitettävä Google Cloud ‐projekti Play Consolessa. Voit linkittää projektin näin:
- Avaa Play Console ja siirry Sovelluksen vaatimustenmukaisuus ‑sivulle (Julkaisu > Sovelluksen vaatimustenmukaisuus).
- Vieritä Play Integrity API ‐kohtaan.
- Valitse "Linkitä projekti" ja projekti, jonka haluat linkittää.
- Valitse Linkitä Cloud-projekti.
Voit aloittaa Integrity APIn integroinnin sovellukseesi näin:
- Asenna Java/Kotlin‑sovellusten uusin saatavilla oleva Android-kirjasto Play Integrity APIa varten Googlen Maven-tietovarastosta.
- Jos kyseessä on Unity-peli, asenna uusin versio Google Playn Unity-laajennuksista. Kaikkia 2019.x-, 2020.x- ja uudempia versioita tuetaan. Jos käytät Unity 2018.x:ää, asenna 2018.4 tai uudempi. Jos käytät Unity 2017.x:ää, asenna 2017.4.40 tai uudempi. Unity 5.x:ää ja vanhempia versioita ei tueta.
- Play Core Native SDK natiivisovelluksille ja ‐peleille.
Voit nyt aloittaa Play Integrity APIn käytön sovelluksessa tai pelissä seuraamalla Android-kehittäjien sivuston ohjeita.
(Valinnainen) Muokkaa Integrity API ‐vastauksia
Android-kehittäjien sivustolta saat lisätietoja APIn eheysvastausten määrittämisestä.
Voit muokata API-vastauksiasi näin:
- Avaa Play Console ja siirry Sovelluksen vaatimustenmukaisuus ‑sivulle (Julkaisu > Sovelluksen vaatimustenmukaisuus).
- Vieritä Play Integrity API ‐kohtaan.
- Valitse Asetukset.
- Vieritä Ilmoitukset-osioon.
- Valitse Muokkaa.
- Valitse muutettavien API-vastausten valintaruudut tai poista niiden valinnat.
- Klikkaa Tallenna muutokset.
Tärkeää: API-vastauksiin tehdyt muutokset tulevat voimaan välittömästi tallentamisen jälkeen (myös silloin, kun sovellus on tuotannossa). Ennen kuin muutat sovellusliittymän vastauksia Play Consolessa, varmista, että palvelimesi on valmis hyväksymään vastaukset.
(Valinnainen) Määritä klassisen pyynnön asetukset
Google hallinnoi oletuksena klassisten pyyntöjen vastausten salausta. Halutessasi voit kuitenkin hallinnoida vastausten salausta itse.
Tärkeää: Vastausten salauksen hallinnoijan vaihtaminen Googlesta sinuksi edellyttää muutosten tekemistä koodiin taustapalvelimessa.
Jos haluat hallinnoida vastausten salausta itse:
- Avaa Play Console ja siirry Sovelluksen vaatimustenmukaisuus ‑sivulle (Julkaisu > Sovelluksen vaatimustenmukaisuus).
- Vieritä Play Integrity API ‐kohtaan.
- Valitse Asetukset.
- Vieritä Klassiset pyynnöt ‑osioon. Vastausten salaus ‐kohdan vieressä näkyvä tila on oletuksena "Googlen hallinnoima". Valitse Muuta.
- Valitse "Hallitse ja lataa vastausten salausavaimia" ja klikkaa Tallenna muutokset. Google luo vastausten salausavaimet, joita voit ladata ja hallinnoida. Päivitä backend-palvelinlogiikka, jotta voit salata vastauksia avaimilla.
- Luo .pem-tiedosto noudattamalla näytöllä näkyviä ohjeita ja lataa .pem-tiedosto lataamalla API-avaimet.
- Näytöllä näkyvä viesti vahvistaa, että vastausten salausavainten hallinta on päivitetty.
- Lataa uudet vastausten salausavaimet ja päivitä backend-palvelin, jotta voit purkaa vastaukset avaimilla tuotannossa. Palaa Integrity API ‑välilehdelle Sovelluksen eheys ‐sivulla, jotta voit antaa Google Playn käyttää uusia vastausten salausavaimia vanhojen avainten sijaan. Muutos tapahtuu heti.
Jos haluat palauttaa hallinnoinnin itsellesi Googlen sijaan:
- Avaa Play Console ja siirry Sovelluksen vaatimustenmukaisuus ‑sivulle (Julkaisu > Sovelluksen vaatimustenmukaisuus).
- Vieritä Play Integrity API ‐kohtaan.
- Valitse Asetukset.
- Vieritä Klassiset pyynnöt ‑osioon. Vastausten salaus ‐kohdan vieressä näkyvä tila on "Itse hallinnoitu", koska olet muuttanut sitä aiemmin. Valitse Muuta.
- Valitse "Anna Googlen hallita vastausten salausta (suositeltu)" ja klikkaa sitten Tallenna muutokset. Google luo vastausten salausavaimet ja hallinnoi niitä. Backend-palvelin kutsuu Google Playn palvelinta vastausten salaamiseksi.
Play Integrity APIn integroinnin testaaminen
Voit testata Integrity APIn integrointia luomalla listan Gmail-tileistä. Varmista ensin, että testaajilla on julkaisun käyttöoikeus: Julkaise sovellus sisäiselle testikanavalle tai kanavalle, jota haluat testata. Seuraa sitten ohjeita testaajien hallinnasta sähköpostiosoitteiden mukaan tai Google Ryhmien kautta, jotta testaajat voivat käyttää julkaisua.
Testin käyttöönotto:
- Avaa Play Console ja siirry Sovelluksen vaatimustenmukaisuus ‑sivulle (Julkaisu > Sovelluksen vaatimustenmukaisuus).
- Vieritä Play Integrity API ‐kohtaan.
- Valitse Asetukset.
- Vieritä Testaus-osioon.
- Valitse Luo uusi testi.
- Valitse postituslista tai luo uusi.
- Valitse Luo testi.
Sovelluksen tietosivun yksilöinti, kun käyttäjät siirtyvät Integrity APIn valintaikkunoista
Integrity APIn korjausvalintaikkunan avulla voit kehottaa sovelluksesi epävirallisesti hankkineita käyttäjiä lataamaan sovelluksen Google Playsta. Kun käyttäjät napauttavat valintaikkunaa, heidät uudelleenohjataan sovelluksen tietosivulle, jossa he voivat napauttaa asennus‑painiketta (tai osta‑ tai päivitä‑painiketta), jotta sovellus lisätään käyttäjän Play-kirjastoon.
Voit muokata sovelluksen tietosivun elementtejä kaikille kävijöille, jotka napauttavat Integrity APIn korjausikkunoita, esimerkiksi sovelluksen nimeä, kuvaketta, kuvauksia ja graafista sisältöä. Näin voit muokata sovelluksen tietosivua, kun käyttäjät siirtyvät Integrity APIn valintaikkunasta:
- Avaa Play Console ja siirry Sovelluksen vaatimustenmukaisuus ‑sivulle (Julkaisu > Sovelluksen vaatimustenmukaisuus).
- Vieritä "Play Integrity API" ‐kohtaan.
- Valitse Asetukset.
- Vieritä "Muokkaa sovelluksen tietosivua" ‐kohtaan.
- Klikkaa Luo tietosivu.
- Seuraa Luo yksilöity tietosivu ‑sivun ohjeita ja klikkaa Tallenna.
Voit myös luoda yksilöityjä tietosivuja Integrity APIn valintaikkunoille suoraan "Yksilöidyt sovellusten tietosivut" ‐sivulta:
- Avaa Play Console ja siirry Yksilöidyt sovellusten tietosivut ‐sivulle (Kasvu > Yksilöidyt sovellusten tietosivut).
- Klikkaa Luo tietosivu ja valitse, haluatko luoda uudet vai kopioida aiemmin luodut tiedot. Valitse sitten Seuraava.
- Etsi "Tiedot"-kohdasta "Kohdeyleisö"-kohta.
- Valitse URL-osoitteen mukaan ja kirjoita tekstikenttään "playintegrity".
- Lisää kaikki muut tiedot ja klikkaa Tallenna.
Vinkki: URL-parametri "playintegrity" on erityinen avainsana, joka on varattu eheys-täsmälinkeille, joten se on lisättävä täsmälleen yksilöidyn tietosivun käyttöönoton yhteydessä.
Play Integrity APIn päivittäisten enimmäispyyntöjen lisääminen
Sovellukset voivat oletuksena tehdä Integrity APIlle jopa 10 000 pyyntöä päivässä.
Näin näet sovelluksesi tekemien pyyntöjen määrän:
- Avaa Play Console ja siirry Sovelluksen vaatimustenmukaisuus ‑sivulle (Julkaisu > Sovelluksen vaatimustenmukaisuus).
- Vieritä Play Integrity API ‐kohtaan.
- Katso pyyntöjen päivittäinen määrä. Jos haluat nähdä lisää dataa, muuttaa ajanjaksoa ja käyttää suodattimia, klikkaa Näytä Integrity APIn raportti.
Näin voit nähdä sovelluksen päivittäisten pyyntöjen enimmäismäärän:
- Avaa Play Console ja siirry Sovelluksen vaatimustenmukaisuus ‑sivulle (Julkaisu > Sovelluksen vaatimustenmukaisuus).
- Vieritä Play Integrity API ‐kohtaan.
- Valitse Asetukset.
- Tarkista käyttötasosi.
Voit pyytää lupaa tehdä yli 10 000 pyyntöä päivässä. Sinun on täytettävä nämä ehdot:
- Vahvista API-logiikan oikea toteutus, myös uudelleenyritykset.
- Julkaise sovellus Google Playssa muiden jakelukanavien lisäksi.
Jos haluat lisätä päivittäisten pyyntöjen määrää, täytä tämä lomake.