Przejdź do treści

Przewodniki

Strony polegające

Strona polegająca to Twój klient lub ktokolwiek inny, przed kim odpowiadasz, kto ocenia każdą wersję Twojego systemu AI według ewaluacji, którą sam przypiął. Workspace rozstrzyga każdą wersję względem jej przypięcia obok Twojej własnej bramki, a ona pobiera rekord decyzji każdej wersji i sprawdza go na własnej maszynie. Nigdy nie widzi Twoich przypadków, etykiet ani śladów, a nic, co zrobisz ze swoim własnym wymaganiem, nie zmienia jej przypięcia.

Rekord to dowód, który druga strona może sprawdzić, a nie certyfikacja.

Zaproś stronę polegającą

W hostowanym projekcie otwórz Relying parties (w grupie Assurance palety poleceń albo z Governance). Zapraszać może tylko Owner: podaj nazwę organizacji, a następnie sam, jeden raz, wyślij wyświetlony link. Działa przez siedem dni.

Strona polegająca otwiera link po zalogowaniu się kontem własnej organizacji. Konto będące członkiem Twojego workspace'u nie może przyjąć zaproszenia, a konto, które później dołączy do Twojego workspace'u, traci strony strony polegającej. Obie strony widzą adres e-mail konta, które przyjęło zaproszenie: sprawdź, czy jest tym, którego się spodziewasz.

Co robi strona polegająca

1. Weryfikuje wysłany przez Ciebie rekord. Wyeksportuj go ze strony zarządzanego uruchomienia (Download the decision record) i wyślij. Ona uruchamia:

``bash oloproof record verify record.json --key KEY_ID=PUBLIC_KEY --workspace-keys keys.json ``

z kluczem publicznym Twojego runnera, który operator runnera przekazuje jej bezpośrednio, oraz opublikowanymi przez wdrożenie kluczami oświadczeń workspace'u, zapisanymi z /api/workspace-statement-key.

Gdy znasz już id swojej strony polegającej (na swojej stronie), dodawaj --relying-party RP_ID do każdego kolejnego sprawdzenia: rekord należący do innej strony polegającej lub do samego dostawcy zostanie wtedy odrzucony.

2. Przypina ewaluację. Na swojej stronie wkleja evaluation.digest, evaluation.policy_digest i id rozstrzygniętego uruchomienia z rekordu. Digest ewaluacji wiąże zestaw (każdy przypadek i jego treść), ewaluatory według treści, specyfikacje metryk i politykę, więc okrojony zestaw lub łagodniejsza polityka dają inny digest. Polityka musi być taka, którą workspace sprawdził. To uruchomienie jest punktem odniesienia (baseline), względem którego rozstrzygana jest każda reguła porównania, pokazanym na jej stronie, więc nie możesz go wybrać kolejnością, w jakiej robisz push. Przypięcie nigdy nie jest zastępowane: dodaje się nowe, a obowiązuje najnowsze.

3. Potwierdza klucze Twojego runnera. Jej strona wyświetla każdą rejestrację i każde unieważnienie klucza runnera projektu, tak jak nastąpiły, z dziennika, którego nikt nie może edytować. Klucz liczy się dla jej przypięcia dopiero wtedy, gdy potwierdzi jego rejestrację, więc klucz zarejestrowany przez Ciebie później niczego dla niej nie rozstrzyga, dopóki nie porówna jego klucza publicznego z tym, który dał jej Twój operator. Uruchomienie na zarządzanych workerach Oloproof nie wymaga potwierdzenia: tego klucza ani nie rejestrujesz, ani nie rotujesz.

4. Pobiera każdy rekord. Strona wyświetla każdą wersję systemu rozstrzygniętą względem jej przypięcia, ze stanem każdej reguły i linkiem Download do rekordu. Pobiera rekordy sama, więc nie zależy od tych, które zdecydujesz się jej wysłać.

Jak rozstrzygana jest każda wersja

Worker przyjmuje przypięte uruchomienie jako baseline, gdy jest ono zweryfikowanym wykonaniem podpisanym kluczem, który potwierdziła, i rozstrzyga każdą wersję systemu na podstawie jej najwcześniejszego startu tej ewaluacji, niezależnie od tego, jaki klucz go podpisał i co się z nim stało. Nieudanego pierwszego uruchomienia nie można zastąpić szczęśliwszym powtórzeniem, a wersja po raz pierwszy uruchomiona pod kluczem, którego nigdy nie potwierdziła, pozostaje wstrzymana. Reguły rozstrzyga ten sam kod co Twoją bramkę, przy zweryfikowanym wykonaniu.

Decyzja nie przetrwa tego, na czym się opiera. Jeśli klucz baseline zostanie unieważniony jako skompromitowany albo ona przypnie ponownie, każda bramka, której obowiązujące przypięcie już nie rozstrzyga, zostaje wstrzymana (MANUAL_REVIEW) z podaniem powodu. Klucz liczy się tylko z kluczem publicznym, który potwierdziła, a uruchomienie na zarządzanych workerach Oloproof tylko pod własnym kluczem wdrożenia.

Co dodaje jej rekord

Rekord wyeksportowany dla strony polegającej zawiera, w podpisanym oświadczeniu workspace'u:

  • stronę polegającą, dla której jest przeznaczony, i jej przypięcie jako wymaganie;
  • każdy start wersji na ewaluacji, każdy z własnym podpisanym żądaniem runnera, które record verify sprawdza względem podanych przez nią kluczy;
  • dziennik kluczy każdego klucza, który podpisał start lub uruchomienie wersji: jego klucz publiczny, rejestrację, potwierdzenie i ewentualne unieważnienie.

record verify odrzuca rekord, jeśli podpisany start się nie zgadza lub wskazuje inne uruchomienie, wersję, zestaw, workspace lub projekt, jeśli klucz publiczny zapisanego klucza nie jest tym, który podała, jeśli zaliczona bramka opiera się na kluczu, którego nie potwierdziła, lub na kluczu zapisanym jako skompromitowany, albo, z --relying-party, jeśli rekord nie jest jej lub jego oświadczenie nie jest podpisane kluczem oświadczeń workspace'u, który podała. Bez --relying-party niepodpisane oświadczenie jest odczytywane jako not checked, nigdy jako zweryfikowane. Kody wyjścia się nie zmieniają: 0, gdy każde sprawdzenie, które dało się wykonać, przeszło, 5, gdy jedno się nie powiodło, 2, gdy nie można odczytać klucza lub pliku.

Czego nie może Ci powiedzieć

  • Że konto, które przypięło i potwierdziło, należy do strony polegającej: adres e-mail jest pokazany, a nie udowodniony.
  • Że runner wykonał tylko kod kontrolowany przez swojego operatora ani że oceniana wersja jest tą, która działa na produkcji.
  • Że ewaluacja jest właściwa: wybór zestawu nadal należy do dostawcy, chyba że strona polegająca dostarczy zestaw lub przypnie ewaluację ruchu pobraną z produkcji.
  • Niczego, co powiedziano po eksporcie: rekord to słowo workspace'u w chwili eksportu; w razie wątpliwości pobierz świeży.
  • Niczego po tym, jak operator zakończy relację. Ty nie możesz jej zakończyć: projektu ani Twojego konta jako ostatniego Ownera jego workspace'u nie można usunąć, dopóki jest do niego dołączona strona polegająca. Mimo to pobieraj każdy rekord, gdy tylko zostanie rozstrzygnięty.
  • Przedziału PPI: etykiet stojących za próbą ludzką nie ma w rekordzie.