Przejście z wersji Beta

Ten artykuł jest przeznaczony dla Organizacji utworzonych w ramach modelu dostępu Beta, w którym administrator indywidualnie przyznawał uprawnienia każdemu Użytkownikowi. Dostęp jest teraz zbudowany w oparciu o Profile przepływu pracy i Role konta, a Kraken konwertuje Twoją Organizację automatycznie.

Dwie rzeczy wymagają Twojej uwagi przed konwersją:

  • Jeśli używasz kluczy API, Twoje integracje muszą zostać zaktualizowane w pierwszej kolejności. Zmienił się sposób, w jaki żądania wybierają konto, a pomyślne wywołanie wypłaty nie oznacza już, że środki zostały przeniesione. Zobacz „Zaktualizuj swoje integracje API” poniżej.
  • Poprosimy Cię o potwierdzenie gotowości. Twoja Organizacja nie zostanie skonwertowana, dopóki nie zaakceptujesz zmiany.

Konwersja nie usuwa żadnego dostępu. Każde uprawnienie posiadane przez każdego Użytkownika zostanie przeniesione.

Twoje istniejące klucze API nie są unieważniane ani ponownie wydawane. Ich poświadczenia, uprawnienia i mapowanie kont zostają przeniesione. Zmienia się sposób, w jaki Twój kod obsługuje żądania i odczytuje odpowiedzi.

Wybierz konto dla każdego żądania

Klucz API Organizacji obejmuje jedno lub więcej Kont i nie ma domyślnego, więc każde prywatne żądanie musi określać, do którego Konta się odnosi. Przekaż account_id jako parametr zapytania w adresie URL, a nie w treści żądania:

bash

Bash

POST /0/private/AddOrder?account_id=W5PB62NTPNYT6TYH

Dotyczy to handlu, zapytań o saldo i księgę, historii zleceń i transakcji, eksportów oraz ruchów środków.

Uwaga:

Odczytaj nową odpowiedź wypłaty

WithdrawFunds zwraca approval_request_id wraz z refid:

bash

Bash

{
  "error": [],
  "result": {
    "refid": "FTcLNGa-4ZWmo4GCo8wrBNZz5v53v9",
    "approval_request_id": "656a021a-1d55-42c9-853a-aea57bf5abd1"
  }
}
  • Refid nie oznacza już, że wypłata została zakończona. Kwota jest blokowana na koncie źródłowym w momencie złożenia żądania i rozlicza się dopiero po zatwierdzeniu żądania.
  • approval_request_id jest identyfikatorem zatwierdzenia, na które czeka wypłata. Zapisz go w swojej dokumentacji.
  • Wypłaty oczekujące na zatwierdzenie nie pojawiają się w WithdrawStatus. Odrzucone lub wygasłe żądanie nie tworzy w ogóle rekordu wypłaty, więc brak w WithdrawStatus nigdy nie oznacza, że wypłata nie została złożona.

Automatyzacja, która traktuje refid jako dowód zakończenia, zgłosi wypłaty jako rozliczone, podczas gdy nadal znajdują się one w kolejce zatwierdzeń. Zobacz klucze API, aby zapoznać się z pełnym modelem.

Twoja Organizacja po konwersji będzie zawierać dwa zestawy standardowych bloków konstrukcyjnych.

Profile przepływu pracy

Profil przepływu pracy określa, co Użytkownik może robić w ramach każdego zarządzanego przepływu pracy. Każdy Użytkownik posiada dokładnie jeden.

Profil

Co zawiera

Administrator

Każdy poziom w każdym przepływie pracy, w tym Wykonaj

Inicjator

Przeglądaj i Inicjuj w każdym przepływie pracy. Nie może zatwierdzać

Zatwierdzający

Przeglądaj i Zatwierdzaj w każdym przepływie pracy. Nie może inicjować

Audytor

Przeglądaj w każdym przepływie pracy. Nie może działać

Menedżer Funduszy

Przeglądaj, Inicjuj i Zatwierdzaj w przypadku Żądania wypłaty i Żądania transferu. Przeglądaj i Inicjuj w przypadku Zarządzania adresami

Role konta

Rola konta określa, co Użytkownik może robić na Twoich Kontach. Standardowe role obejmują wszystkie bieżące i przyszłe Konta, więc Użytkownik z rolą „Trade all” może handlować na Koncie, które utworzysz jutro.

Rola

Co przyznaje na każdym koncie

Odczyt wszystkich

Odczyt

Handel wszystkimi

Handel

Wszystkie środki

Przelew, Wypłata, Alokacja zarobków, Dealokacja zarobków

Pełny dostęp

Każde uprawnienie konta

Standardowe profile i role dotrzymują kroku produktowi: po dodaniu nowego przepływu pracy, Członkowie posiadający jeden z nich automatycznie uzyskują odpowiedni poziom. Zobacz Role, profile i uprawnienia, aby zapoznać się z pełnym modelem.

Jeśli uprawnienia Członka nie pasują do żadnego standardowego profilu, zostaje on przypisany do roli, która posiada dokładnie te same uprawnienia, które miał. Członkowie z identycznymi uprawnieniami współdzielą jedną rolę, więc Twoja Organizacja będzie miała znacznie mniej ról niż Członków.

Te role przyjmują nazwę z etykiety, którą przypisałeś Członkowi, więc Członek oznaczony jako „Trader” trafia do roli o nazwie trader. Członkowie bez etykiety trafiają do migrated-role. Każda rola posiada odznakę migrated, co oznacza, że nazwa została wygenerowana i możesz ją zmienić.

Wskazówka:

Zmiana nazw tych ról, aby odpowiadały temu, jak faktycznie nazywasz te osoby, jest najlepszym pierwszym zadaniem po konwersji. Edycja roli usuwa odznakę migrated.

Dlaczego Twoi Członkowie „Admin” nie znajdują się w profilu Admin

Etykieta Beta „Admin” pozwalała komuś przeglądać, inicjować i zatwierdzać, ale nie realizować własnych żądań bez drugiego zatwierdzenia. Profil Admin obejmuje tę możliwość, która jest poziomem Wykonania (Execute).

Zamiast automatycznego przyznawania, Członkowie ze starą etykietą są przypisywani do roli o nazwie beta-admin, która posiada dokładnie te same uprawnienia, które mieli wcześniej. Przeniesienie ich do roli Admin to pojedyncze przypisanie, gdy tylko podejmiesz taką decyzję.

Uwaga:

beta-admin to jedna z Twoich własnych ról, więc Członkowie ją posiadający nie będą automatycznie uzyskiwać dostępu do nowych przepływów pracy w taki sposób, jak standardowe profile do. Jest to kolejny powód, aby przejrzeć te role wkrótce po konwersji.

Właściciel (Owner) zostaje przypisany do profilu Admin, zachowuje wszystkie swoje dotychczasowe uprawnienia i automatycznie uzyskuje dostęp do nowych przepływów pracy. Właściciel posiada również uprawnienie Odczyt wszystkich, którego nie można usunąć.

Jeśli celowo zmniejszyłeś uprawnienia Właściciela, ta decyzja zostaje zachowana: Właściciel przekształca się w rolę posiadającą jego rzeczywiste uprawnienia, podobnie jak każdy inny Członek.

  • Wszystkie uprawnienia posiadane przez każdego Członka zostają przeniesione.
  • Poświadczenia klucza API, uprawnienia i mapowanie Konta są zachowane.
  • Salda, Konta i własność Konta pozostają nienaruszone.
  • Wnioski o zatwierdzenie będące już w toku są kontynuowane, a Twoje polityki, progi zatwierdzeń i ustawienia „zawsze wymagaj zatwierdzenia” pozostają bez zmian.
  • Weryfikacja tożsamości pozostaje bez zmian, i nikt nie musi logować się ponownie ani być ponownie zapraszany.
  • Konwertowane są tylko Konta należące do Twojej Organizacji. Uprawnienie na dowolnym Koncie poza nią pozostaje bez zmian.

Rozwiązywanie problemów

Żądanie z niemal pewnością nie zawiera account_id. Bez niego prywatne wywołanie nie jest przypisywane do jednego z Kont klucza i może zwrócić pusty wynik zamiast błędu. Dodaj account_id do adresu URL i ponownie sprawdź każdy punkt końcowy, który wywołuje Twoja integracja, nie tylko te, które widocznie zakończyły się niepowodzeniem. Zobacz klucze API.

Wywołanie utworzyło żądanie i zablokowało kwotę na Koncie źródłowym. Rozliczenie następuje po zatwierdzeniu. Śledź żądanie za pomocą approval_request_id zwróconego przez wywołanie lub znajdź je na stronie Żądania. Zobacz Transfery i wypłaty.

Członkowie, których uprawnienia nie odpowiadały standardowemu profilowi, potrzebują roli, która zachowuje ich dostęp, a dwóch Członków jest łączonych w jedną rolę tylko wtedy, gdy ich uprawnienia są identyczne. Członkowie, którym nadałeś inne etykiety, pozostają na oddzielnych rolach, nawet jeśli ich uprawnienia są zgodne, ponieważ etykiety sugerują, że rozróżnienie było zamierzone. Role, których nie potrzebujesz, możesz skonsolidować, ponownie przypisując ich Członków i usuwając pustą rolę.

Członkowie, którzy administrują Organizacją, zarządzając dostępem zespołu, Kontami lub kluczami API, są umieszczani w grupie „Odczyt wszystkich”, ponieważ administrowanie Kontem oznacza możliwość jego zobaczenia. Jeśli jest to szersze niż chcesz, zastąp „Odczyt wszystkich” Rolą Konta, ograniczoną do konkretnych Kont, których potrzebują.

Nie. Konwersja jest jednostronna. Wszystko, co produkuje, jest później edytowalne, więc każde uzgodnienie dostępu, które miałeś, może zostać odbudowane przy użyciu profili i ról.

Potrzebujesz dodatkowej pomocy?