Kimlik bilgisiyle kapı tutulan aracılık

Çoğu aracı ajanları bir API anahtarıyla kabul eder. Relay onları bunun yerine sunulmuş bir kimlik bilgisiyle kabul edebilir: ajan kendisi hakkında bir şeyi kanıtlar ve aracı o kanıttan karar verir.

Neden bir anahtar yerine bir kimlik bilgisi

Bir API anahtarı hamiline yazılı bir sırdır. Onu kimin tuttuğu hakkında hiçbir şey söylemez, en son nereye kopyalandıysa o kadar güçlüdür ve iptali bant dışı bir işlemdir. Birçok ajana hizmet veren bir aracı için bir işletmecinin gerçekten sahip olduğu sorular, yani bu ajan nedir, onu kim işletiyor, burada olmaya hâlâ hakkı var mı, tam olarak hamiline yazılı bir jetonun yanıtlayamadığı sorulardır.

Bir kimlik bilgisi o iddiaları taşıyabilir ve kabulde, ayrıca teslimatta kontrol edilebilir.

Kapı nerede çalışır

İki yerde ve ikisinde de aynı fonksiyondur: canlı mediate-grant ve teslimat yolu, ve bir işletmecinin bir kuralı uygulamadan önce denemek için kullandığı politika testi uç noktası.

Bu, kulağa geldiğinden daha çok önem taşır. Test paneli kapının benzetilmiş bir kopyasını çalıştırsaydı, test gerçekte çalışandan başka bir şeyi tarif ediyor olurdu ve eninde sonunda üretimle anlaşmazlığa düşerdi. Test ettiği şeyden sapabilen bir test, hiç test olmamasından kötüdür, çünkü insanlar ona güvenir.

Hataya kapalı, ayırt edilebilir bir sebeple

Kimlik bilgisi kontrolü doğrulama hizmetine ulaşamadığında relay engeller ve "kimlik bilginiz geçersizdi"den farklı bir sebep bildirir.

O ayrım tasarımın tamamıdır:

Karar	Anlamı
open	Bu politikada yapılandırılmış kapı yok, kabul edildi.
pass	Bir kimlik bilgisi sunuldu ve politikayı karşıladı.
no-credential	Politika bir tane istedi; hiçbiri sunulmadı.
invalid	Bir kimlik bilgisi sunuldu ve politikayı karşılamadı.
unreachable	Doğrulayıcıya ulaşılamadı. Engellendi, ama bu ajan hakkında bir hüküm değil bir altyapı arızasıdır.

unreachable'ı invalid içine katlamak, aslında bir bağımlılık çökmüşken bir işletmeciye ajanın kimlik bilgisinin başarısız olduğunu söylerdi. Sonra birisi gidip ajanı ayıklardı. "Bozuk"u "ihlal"den ayıramayan bir koruma, insanları onu göz ardı etmeye alıştırır.

Hataya kapalı, kabul için doğru varsayılandır ve belirtmeye değer bir işletim maliyeti vardır: doğrulama hizmeti çökerse yeni aracılık kabulleri durur. Bu kasıtlıdır ve buna bağımlı olmadan önce bilmelisiniz.

Kapı kararı neyi içerir, neyi içermez

Kapı sebepleri yalnızca işletmeciye dönük üstveridir; hiçbir zaman mesaj içeriği içermez. Aracı mesaj gövdelerini hiç okuyamaz (bir aracının görebildikleri ve göremedikleri) ve kabul katmanı buna bir istisna hâline gelmez.

Bu ne değildir

• Relay'in yaptığı bir kimlik doğrulaması değildir. Relay bir kimlik bilgisini bir politikaya karşı kontrol eder; ihraç ve doğrulama hizmeti Solidus'un başka yerlerindedir. Relay, kapı politikası olan bir taşımadır.
• Bir KYC iddiası değildir. Bir ajanı bir kimlik bilgisiyle kabul etmek, düzenlenmiş herhangi bir yükümlülük hakkında hiçbir şey söylemez ve bir tanesini kabul etmek dayanan bir tarafın kendi görevlerini asla ortadan kaldırmaz.
• Bir Seyahat Kuralı ürünü değildir. Solidus'ta böyle bir ürün yoktur. Relay şifreli zarflar taşır.
• Bir mahremiyet denetimi değildir. Kimin bağlanabileceğine kapı tutmak, aracının bağlananlar hakkında gözlemlediğini azaltmaz.

Yapılandırmak

Politikalar, gerçek kapıyı çalıştıran bir test uç noktasıyla birlikte, kimlik doğrulaması gereken işletmeci düzleminde /v1/policies adresinde yaşar. Konsol örnek veri gösterir ve bunu sayfada söyler; rakamlarını ölçüt olarak okumayın.

Relay, Coordinate Mediation 2.0 ve Pickup 3.0 uygular; bağımsız bir DIDComm uygunluk paketi çalıştırılmamıştır, dolayısıyla iddia "uygular"dır, "uygundur" değil.