Skip to content
GUIDE-0008RehberYürürlüktesürüm 1.0.05 Kasım 2026

Doğrulayıcı olarak kayıt olmak ​

Bu rehber, kişilerin cüzdanından belge isteyecek siteler ve hizmetler (mağaza, işveren, kurum portalı, etkinlik girişi) içindir.

Ne zaman okunur:

  • İlk sunum isteğinizi göndermeden önce. Kayıtsız bir doğrulayıcının istediği her alan, kişiye ayrı bir uyarıyla "kayıtlı kapsamın dışında" diye gösterilir; takma ad isteği hiç kabul edilmez.
  • Sonra: GUIDE-0001 (Tamga ile giriş) ya da GUIDE-0002 (sunucuda doğrulama).
  • Başvuru dosyası, erişim anahtarı ve kurulum denetimi için katılım aracı: GUIDE-0014.
  • Belge vermek istiyorsanız bunun yerine GUIDE-0007.

Nasıl çalışır? ​

Cüzdan, bir istek geldiğinde üç şeyi güven listesinden (trust list)Bir ülkenin kök sertifikalarını, belge verenlerini ve kayıtlı relying party'lerini taşıyan imzalı liste. Bugün Tamga'da güven bu listelere dayanır; ortak defter sonra gelir. denetler: isteği kim gönderiyor, bu doğrulayıcı kayıtlı ve etkin mi, istenen alanlar kayıtlı kapsamın içinde mi? Kapsam dışı bir alan istenirse kişiye ayrı bir uyarı gösterilir. Kayıt, bu üç sorunun cevabını listeye yazdırmaktır.

NeDeğerNereden
Kalıcı kimlikalan adınız (dns_name)başvurunuz
İstemci kimliği (client_id)x509_hash:…erişim sertifikanızdan hesaplanır (ADR-0034)
Erişim sertifikasıX.509, alan adınız ve kurum kimlik numaranızlakayıt kurumu, sizin CSR'ınızdan
Kapsamlarher kullanım için amaç, belge türü, alanlarbaşvurunuz
Kayıt sertifikasıher kullanım için bir rc-wrp+jwtyayında otomatik üretilir (ADR-0026)

1. Anahtar ve sertifika isteği ​

İsteklerinizi imzalayacağınız P-256 anahtarını kendiniz üretin; özel anahtar sizde kalır.

sh
openssl ecparam -name prime256v1 -genkey -noout -out rp.key.pem
openssl req -new -key rp.key.pem -subj "/CN=shop.example.com/O=Example Shop Ltd./C=TR" -out rp.csr.pem

Kayıt kurumu erişim sertifikasına alan adınızı (SAN) ve kurum kimlik numaranızı (organizationIdentifier, örneğin VATTR-…) yazar. Cüzdan, kayıt sertifikasındaki kimlik numarasının bu numarayla eşleştiğini denetler.

2. Başvuru dosyası ​

json
{
  "dns_name": "shop.example.com",
  "legal_name": "Example Shop Ltd.",
  "trade_name": "Example Shop",
  "access_cert": "rp-example-shop",
  "info_uri": "https://shop.example.com",
  "service_description": { "en-US": "Online shop offering student discounts.", "tr-TR": "Öğrenci indirimi sunan çevrim içi mağaza." },
  "is_public_sector_body": false,
  "entitlements": ["service_provider"],
  "scopes": [
    {
      "scope_id": "student-discount-1",
      "purpose": "Student discount",
      "purpose_localized": { "tr-TR": "Öğrenci indirimi" },
      "vct": "urn:tamga:edu:StudentCredential:1",
      "claims": ["is_enrolled"],
      "privacy_policy_uri": "https://shop.example.com/privacy"
    }
  ],
  "identifiers": [{ "scheme": "TR-VKN", "value": "TR0000000000" }],
  "postal_address": { "street_address": "Example Street 1", "locality": "Istanbul", "postal_code": "34000", "country": "TR" },
  "contact": { "support_uri": "https://shop.example.com/help" },
  "supervisory_authority": { "name": "Kişisel Verileri Koruma Kurumu (KVKK)", "country": "TR", "info_uri": "https://www.kvkk.gov.tr", "form_uri": "https://www.kvkk.gov.tr" }
}

Tam örnek: depoda apps/trust-publisher/registry/examples/rp-application.example.json.

Zorunlu alanlar (ADR-0024): ticari ad, resmî kimlik numarası, posta adresi, iletişim (destek adresi, e-posta ya da telefon), hizmet açıklaması, kamu kurumu olup olmadığınız, yetki türü (entitlements), veri koruma kurumu ve başvuru yolu, her kapsam için gizlilik politikası adresi. Eksik alan varsa kayıt yapılmaz; kayıt kurumu eksiklerin tamamını tek seferde bildirir.

3. Kapsamı dar tutun ​

Her kapsam (scopes[]) bir kullanımdır: bir amaç, bir belge türü ve o amaç için gereken en az alan. Örnekteki mağaza öğrenci olup olmadığını (is_enrolled) sorar; adı, okulu, numarayı sormaz.

  • Gereken her ayrı amaç için ayrı kapsam açın; amacı kişinin anlayacağı dilde yazın (purpose_localized).
  • Bazı türler hiç gösterilmez (örneğin takma ad tohumu, urn:tamga:id:PseudonymSeed:1); bunlar kapsama yazılamaz.
  • Sıfır bilgi ispatıyla yaş doğrulaması kimlik belgesinin kısa ömürlü ZK kopyasıyla yapılır; kapsamın türü urn:tamga:id:ShortLivedIdentityAttestation:1, alanı age_over_18 ya da age_over_15'tir (ADR-0044, ADR-0064). Yaş kapsamı tek eşik ister; iki eşiği birden isteyen kapsam yaş aralığını ele verir ve ayrıca gerekçelendirilir.
  • Kapsam süreli olabilir (valid_from, valid_until); süresi biten kullanım için kayıt sertifikası üretilmez.

4. Kayıt sertifikası ​

Liste her yayınlandığında, her geçerli kapsamınız için bir kayıt sertifikası (registration certificate)Kayıt kurumunun, bir relying party'nin hangi alanları hangi amaçla isteyebileceğini bildiren imzalı belgesi (en çok 12 ay). (WRPRC, ETSI TS 119 475) üretilir ve trust.tamga.network/wrprc/ altında yayınlanır (dizin: wrprc/index.json). İçerik yalnız imzalı listedeki kaydınızdan gelir; ayrı bir kayıt kurumu anahtarıyla imzalanır; en çok 12 ay geçerlidir.

Sunum isteğinizde bu sertifikayı verifier_info içinde (registration_cert) gönderirsiniz. Cüzdan imzayı, süreyi, kimlik numarası eşleşmesini ve istenen alanların sertifikadaki kapsamla uyumunu denetler (ADR-0026).

Sertifika kullanımın hizmet kimliğini de taşır (service_id; ARF RPRC_17a). Başvuruda bir kullanıma "service_id" verirseniz o yazılır (aynı hizmetin birden çok kullanımını tek adla toplar), vermezseniz scope_id. Belge verenler bir belge türünü yalnız belirli doğrulayıcı ve hizmetlere gösterilmek üzere sınırlayabilir (GUIDE-0003, paylaşım kuralı; ADR-0046): izinli değilseniz cüzdan kişiyi uyarır ve varsayılan seçim "Paylaşma"dır.

5. Aracı doğrulayıcı ​

Başka siteler adına doğrulama yapan bir hizmetseniz (barındırılan doğrulayıcı gibi) aracı (intermediary)Bir relying party adına belge doğrulayan hizmet; cüzdan hem aracıyı hem de hizmet verdiği relying party'yi gösterir. olarak kaydolursunuz (served_relying_parties[]); asıl site de kaydında sizi gösterir (uses_intermediaries[]). Cüzdan ekranda asıl sitenin adını gösterir ve kapsamı onun kaydına göre denetler (ADR-0017).

6. Takma ad (isteğe bağlı) ​

Kişiyi kimliğini öğrenmeden tanımak istiyorsanız (örneğin tekrar gelen müşteri) siteye özel takma ad isteyebilirsiniz. Kaydınızda pseudonyms alanı single (kişi başına bir takma ad) ya da multiple (kişi isterse birden çok) olur (ADR-0031).

7. Kayıttan sonra ​

DurumNe olur
ACTIVEİstekleriniz kabul edilir
SUSPENDEDCüzdan kaydınızı etkin saymaz; kişiye bu açıkça gösterilir
REVOKED / RETIREDKayıt kapandı; cüzdan kaydınızı etkin saymaz

Kapsam eklemek ya da değiştirmek yeni bir başvurudur; değişiklikler en geç 24 saatte yayındadır. Kaydınızı kendi kodunuzla okuyabilirsiniz: source.relyingPartyByDnsName("shop.example.com") (GUIDE-0006).

Kapılar (turnike, bilet kapısı). Geçiş kartı kullanıyorsanız kapı gruplarınız kaydınızın terminal_groups[] alanında yayımlanır: grup kimliği, kapıları işleten kurum (institution_id), grubun kapı politikaları ve isteğe bağlı cihaz sertifikası parmak izleri (ADR-0069). Kapı cihazları Tamga Verify'a terminal anahtarıyla kimlik gösterir (ADR-0065); kurumunuzun yöneticisi anahtarları Kurum Konsolu'nun Kapı terminalleri ekranından oluşturur (anahtar bir kez gösterilir) ve iptal eder. Liste bir grubu geri çekerse o grubun kapıları hemen durur. Okuma: source.terminalGroup("grup-kimligi").

Kurallar ​

KodNe der
ADR-0024 RPR1–RPR3Kayıt verisi eksiksiz olmadan kayıt yapılmaz; her kullanımın gizlilik politikası vardır
ADR-0026Kayıt sertifikası yalnız imzalı listedeki kayıttan üretilir; en çok 12 ay
ADR-0034İstemci kimliği erişim sertifikasından hesaplanan x509_hash; kalıcı kimlik alan adı
ADR-0017Aracı doğrulayıcıda asıl site gösterilir ve kapsamı denetlenir

Doğrulayıcı kurallarının tamamı: Tamga ARF — Tamga Rulebook, RB-RP.