Asset

Bir öğeyi benzersiz olarak tanımlar.

Dijital varlık, genellikle belirli bir hizmet veya içerik sağlayan, tanımlanabilir ve adreslenebilir online tüzel kişilerdir. Öğelere örnek olarak web siteleri, Android uygulamaları, Twitter feed'leri ve Artı Sayfaları verilebilir.

JSON gösterimi 
{
  // Union field, only one of the following:
  "web": {
    object(WebAsset)
  },
  "androidApp": {
    object(AndroidAppAsset)
  },
}
Alan adı Tür Açıklama
Birlik alanı, aşağıdakilerden yalnızca biri:
web object(WebAsset) Bunun bir web öğesi olup olmadığını ayarlayın.
androidApp object(AndroidAppAsset) Bunun bir Android uygulama öğesi olup olmadığını ayarlayın.

WebAsset

Bir web öğesini tanımlar.

JSON gösterimi 
{
  "site": string,
}
Alan adı Tür Açıklama
site string

Web öğeleri yalnızca şema, ana makine adı ve bağlantı noktası bölümlerini içeren bir URL ile tanımlanır. Biçim

http[s]://<hostname>[:<port>]

Ana makine adları tam olmalıdır: Tek bir nokta (".") ile sona ermelidir.

Şu anda yalnızca "http" ve "https" şemalarına izin verilmektedir.

Bağlantı noktası numaraları ondalık sayı olarak verilir ve standart bağlantı noktası numaraları kullanılıyorsa bunlar atlanmalıdır: http için 80 ve https için 443.

Bu sınırlı URL'ye "site" diyoruz. Aynı şemayı, ana makine adını ve bağlantı noktasını paylaşan tüm URL'ler, sitenin bir parçası ve dolayısıyla web öğesine ait kabul edilir.

Örnek: https://www.google.com sitesini içeren öğe şu URL'lerin tümünü içeriyor:

  • https://www.google.com/
  • https://www.google.com:443/
  • https://www.google.com/foo
  • https://www.google.com/foo?bar
  • https://www.google.com/foo#bar
  • https://user@password:www.google.com/

Ancak, aşağıdaki URL'leri içermez:

  • http://www.google.com/ (yanlış şema)
  • https://google.com/ (ana makine adı eşleşmiyor)
  • https://www.google.com:444/ (bağlantı noktası eşleşmiyor) GEREKLİ

AndroidAppAsset

Android uygulama öğesini tanımlar.

JSON gösterimi 
{
  "packageName": string,
  "certificate": {
    object(CertificateInfo)
  },
}
Alan adı Tür Açıklama
packageName string Android uygulama öğeleri doğal olarak Java paket adlarıyla tanımlanır. Örneğin, Google Haritalar uygulaması com.google.android.apps.maps paket adını kullanmaktadır. Zorunlu
certificate object(CertificateInfo)

Paket adı benzersizliğine yönelik global bir yaptırım olmadığından, paket adıyla birlikte bir uygulamayı benzersiz şekilde tanımlayan bir imza sertifikası da gerekir.

Bazı uygulamaların imzalama anahtarları döndürüldüğünden zaman içinde farklı anahtarlarla imzalanabilir. Benzersiz kimlik olarak (paket adı, sertifika) kullandığımızdan bunları ayrı öğeler olarak değerlendiririz. Uygulamanın her iki sürümü de aynı veya benzer ifadeleri kullanacağından bu, normalde herhangi bir sorun teşkil etmez. Bununla birlikte, bir anahtar döndürüldüğünde uygulama hakkında açıklamalarda bulunan diğer öğelerin güncellenmesi gerekecektir.

(Belirtilen ifadeleri yayınlama ve sorgulamaya yönelik söz dizimlerinin, birden fazla sertifika tarafından bilinen uygulamaları kolayca belirtmenizi sağlamak için söz dizimsel şeker içerdiğini unutmayın.) Zorunlu

CertificateInfo

Bir X509 sertifikasını tanımlar.

JSON gösterimi 
{
  "sha256Fingerprint": string,
}
Alan adı Tür Açıklama
sha256Fingerprint string

Sertifikanın büyük harfli SHA-265 parmak izi. PEM sertifikasından şu şekilde edinilebilir:

$ keytool -printcert -file $CERTFILE | grep SHA256:
SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
    42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5

veya aşağıdaki gibi:

$ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
    16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5

Bu örnekte, bu alanın içeriği 14:6D:E9:83:C5:73: 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5 olur.

Bu araçları kullanamıyorsanız PEM sertifikasını DER biçimine dönüştürebilir, söz konusu dizenin SHA-256 karmasını hesaplayabilir ve sonucu onaltılık dize (yani her sekizliğin iki nokta üst üste ile ayrılmış büyük harfli onaltılık gösterimleri) olarak temsil edebilirsiniz.