Oturum açınToplantı planlayın

Bölüm 2.12

İlk çalıştırma

Sahipsiz bir kurulumdan çalışan insanlara. Sahiplenme kodunu oluşturun, bir tarayıcıda kurulumu sahiplenin, bir geçiş anahtarıyla (passkey) ilk yöneticiyi oluşturun, ardından şirket oturum açma yöntemini bağlayın ve diğer herkesi davet edin.

Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

18 dakikalık okuma

Bir kurulum tamamlandığında kurulum hiç kimseye ait değildir. Kuruluşu, kişisi ve oturumu yoktur; hiç kimse oturum açamaz. Bir tarayıcıda, az önce yapılan kurulumla konuştuğunu kanıtlayacak bir kişiyi bekler. Harrow Port Authority'de bu kişi, terminalde yanında Tomás Reilly ile birlikte BT başkanı Aoife Brennan'dı. Bu bölüm, onların ilk yirmi dakikasını izler.

Sıralama sabittir ve her adım kendisinden öncekini kalıcı olarak kapatır: kurulumu sahiplenin, ilk yöneticiyi ve kuruluşu oluşturun, bir geçiş anahtarı (passkey) ayarlayın ve Bugün sayfasına ulaşın. Bundan sonra hazır hale getirilecek altı şey, şirket oturum açma işlemi ve diğer herkesi davet etme adımları size uygun olan sırayla gelir.

Soldan sağa bir kutu zinciri: "nexusctl claim-code (terminal)", "Bu kurulumu sahiplen (tarayıcı: kod + parmak izi)", "İlk yönetici ve kuruluş", "Geçiş anahtarı (ikinci doğrulama)", "Bugün, her şey yeniyken", "Kimse oturum açmadan önce altı şey", "Kişileri davet et". Sahiplenme kutusunun altında iki kırmızı dal aşağı iner: "kod çok eski: CLAIM_CODE_EXPIRED, yeni bir kod oluşturun" ve "parmak izleri farklı: CLAIM_FINGERPRINT_MISMATCH, durun". İlk üç kutunun altındaki ince bir çizgi "her adım kendisinden öncekini kalıcı olarak kapatır" olarak etiketlenmiştir.
Terminalden ilk Bugün sayfasına kadar ilk çalıştırma ve durabileceği iki nokta.

Sahiplenme kodunu oluşturun

Sahiplenme kodu, tarayıcının karşısındaki kişinin kümeye erişimi olan birinin terminalini de görebildiğini kanıtlar. Yalnızca böyle bir kişi kod oluşturabilir. Bunu, kubeconfig dosyanızın kümeye ulaştığı yerde çalıştırın:

nexusctl claim-code --administrator aoife.brennan@harrow.example

nexusctl claim-code, kurulumun anahtar hizmeti olan nexus-keys biriminden kodu oluşturmasını ister. nexusctl olmadan aynı komut anahtar hizmetinin kendi pod'unda çalışır:

kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
  --administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"

--source, kodu kimin oluşturduğunu belirten birkaç kelimedir. Sahiplenme sayfası bunları "Oluşturan" altında gösterir, böylece sahiplenen kişi kodun nereden geldiğini bilir.

 Code  7KQM-4TXD-PL9R  works once, for 30 minutes, until 09:55 · 5 tries
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

Kodla ilgili üç şey önemlidir.

  • 30 dakika geçerlidir. Birinin omzunun üzerinden görülen bir kod kısa sürede işe yaramaz hale gelir.
  • 5 denemeye izin verir. Beşinci yanlış denemeden sonra, süre ne olursa olsun kod tükenir.
  • Tek bir kişi içindir. Verdiğiniz e-posta ilk yöneticinindir. Sahiplenme işlemiyle birlikte taşınır ve ilk yönetici formu bunu yeniden yazılmayacak şekilde sabit olarak gösterir.

Parmak izi, kurulumun kendi kimliği olan dört karakterlik sekiz gruptan oluşur. Ekranda bırakın. Tarayıcıda grup grup karşılaştıracaksınız.

Kurulumu sahiplenin

  1. İlk yönetici olarak kullanacağınız bilgisayarda konsolun kurulum adresini (burada https://console.harrow.example/install) açın. Sizi kurulumun durumuna uygun sayfaya yönlendirir: açıkken sahiplenme sayfasına, sahiplenildikten sonra ilk yönetici sayfasına ve zaten oturum açtıysanız konsola.
  2. Bu kurulumu sahiplen sayfasında kodu her birine dörtlü bir grup gelecek şekilde Birinci grup, İkinci grup ve Üçüncü grup alanlarına yazın.
  3. Sayfadaki Bu kurulumun parmak izi bilgisini terminaldekiyle, sekiz grubun tamamını tek tek karşılaştırın.
  4. Her grup eşleşiyorsa Sekiz grubun tamamı terminalimin gösterdiğiyle eşleşiyor seçeneğini işaretleyin.
  5. Bu kurulumu sahiplen düğmesine basın; sayfa sahiplenmeyi onaylar ve sizi ilk yönetici adımına yönlendirir.
Bu kurulumu sahiplen
Bu kurulumu sahiplen
Sahiplenme sayfası. Kod üç grup halinde girilir, tam parmak izi terminalle karşılaştırmak üzere dörtlü sekiz grup halinde gösterilir ve sağdaki kart kodun nereden geldiğini ve kaç deneme hakkı kaldığını belirtir.

Sahiplenme üç şey yapar. Bu tarayıcıyı ilk yöneticinin oluşturulabileceği tek yer haline getirir. Kurulumu kimin ve ne zaman sahiplendiğini denetim günlüğüne kaydeder. Ve sahiplenme sayfasını kalıcı olarak kapatır. O andan itibaren sahiplenme adresi, kurulumun sahiplenildiği yanıtını verir.

Parmak izi eşleşmiyorsa durun

Farklı bir parmak izi, bu adreste farklı bir kurulumun yanıt verdiği anlamına gelir. Bu, yanlış yazılmış bir adres, eski bir DNS (Alan Adı Sistemi) kaydı veya ilk yöneticiyi yakalamak için kurulmuş bir makine olabilir. Sahiplenirseniz, kuruluşunuzu o makine barındırır.

Sahiplenmeyin ve kodu o sayfaya yazmayın. Sayfayı kapatın, ardından iki şeyi kontrol edin: console.harrow.example adresinin kendi ingress biriminize çözümlendiğini ve tarayıcının gösterdiği sertifikanın beklediğiniz CA (sertifika yetkilisi) tarafından verildiğini. Kendi kurulumunuz değişmemiştir ve hâlâ sahiplenilmemiştir.

Kuruluma ait olmayan bir parmak iziyle sahiplenme gönderilirse anahtar hizmeti bunu CLAIM_FINGERPRINT_MISMATCH (403) ile reddeder. Hiçbir şey sahiplenilmez. Ardından sayfa, farklı olan grupları işaretlenmiş şekilde iki parmak izini yan yana ve adresi ve sertifikayı kontrol etme adımlarını gösterir.

Parmak izi eşleşmiyor
Parmak izi eşleşmiyor
Eşleşmeyen bir parmak izinin yönlendirdiği sayfa. Farklı olan gruplar işaretlenir ve başka bir şey yazılmadan önce adımlar adresi ve sertifikayı kontrol eder.

İlk yöneticiyi ve kuruluşu oluşturun

Ardından gelen sayfa "İki kısa form, sonra içeridesiniz" başlığını taşır. İlk yönetici diğer herkesi ekleyebilir ve buradaki neredeyse her şey daha sonra değişebilir. İki şey değişemez ve sayfa bunları işaretler.

Alan Girilen bilgi Daha sonra değişebilir mi?
Tam ad Adınız Evet
İş e-postası Sahiplenme kodunun oluşturulduğu adres; gösterilir ve tekrar yazılmaz Yöneticinin adresidir
Nexus içindeki rolü Kuruluş yöneticisi. İlk kişi her zaman bir yöneticidir. Burada seçilmez
İkinci doğrulama Bu dizüstü bilgisayardaki geçiş anahtarı Evet, daha fazlası eklenebilir
Ad (kuruluşun adı) Harrow Port Authority Evet
Ülke Kuruluşun bulunduğu yer Evet
Adreslerdeki kısa ad Addan oluşturulur, örneğin harrow-port-authority Hayır. Bağlantılar ve dışa aktarımlar bunu kullanır.
Verilerin tutulduğu yer Bu kurulum Hayır. Daha sonra değiştirmek yeni bir kurulum anlamına gelir.
Dil ve tarihler İngilizce (BK), bugünün tarihiyle Evet
Saat dilimi Sunucunun saat dilimi Her kişi saatleri kendi saat diliminde görür

Kısa ad, kuruluşun adından aksan işaretleri kaldırılarak oluşturulan, en fazla 100 karakter uzunluğunda küçük harfler, rakamlar ve kısa çizgilerden oluşur. Herhangi bir düğmeye basmadan önce buna bakın. Kuruluş var olduğu sürece, kişilerin paylaştığı her bağlantıda ve yaptıkları her dışa aktarımda görünür.

Bu sayfada ayrıca bir parola belirlersiniz. Bu tek başına asla yeterli değildir: Bir yönetici asla yalnızca parolayla oturum açmaz. Oturum açmanızı sağlayan şey aşağıdaki ikinci doğrulamadır.

Aynı zamanda bir acil durum yönetici oturum açma bilgisi oluşturulur. Kasada saklanmak üzere mühürlenir ve bir kez yazdırılır. Yalnızca şirket oturum açma sistemi çalışmadığında işlev görür ve her kullanım kaydedilip tüm yöneticilere duyurulur. Yazdırdığınız gün kasaya koyun.

Sayfa ayrıca kim olduğunuzun Adverant'a bildirilmediğini belirtir. Bu ayrıntılar kurulumda kalır. Bir lisans şirketin adını taşır, içindeki kişilerin adını asla taşımaz.

Oluştur ve oturum aç düğmesine basın. Yöneticinin ve kuruluşun oluşturulması birkaç saniye sürer. Sayfa "aoife.brennan@harrow.example için oluşturuldu. Şimdi geçiş anahtarınızı ayarlayın: Oturum açma yönteminiz budur." yanıtını verir.

İlk yönetici
İlk yönetici
Tek sayfada ilk yönetici ve kuruluş. Asla değişemeyecek iki seçim olan kısa ad ve verilerin tutulduğu yer, alanın yanında bunu belirtir ve acil durum oturum açma bilgisi kasa için mühürlenir.

Geçiş anahtarı (passkey): ikinci kontrol

  1. Geçiş anahtarını ayarla ve oturum aç düğmesine basın.
  2. Tarayıcınız sizden bir geçiş anahtarı oluşturmanızı ister. Touch ID veya Windows Hello bulunan bir dizüstü bilgisayarda parmağınızla, yüzünüzle veya PIN ile onaylayın. Bilgisayar kendi başına bir geçiş anahtarı oluşturamıyorsa tarayıcı bir QR (hızlı yanıt) kodu gösterir: Telefonunuzun kamerasını koda doğrultun ve telefondaki adımları izleyin.
  3. Sayfa "Geçiş anahtarınız ayarlandı ve aoife.brennan@harrow.example olarak oturum açtınız." yanıtını verir ve konsolu açar.

Aynı tarayıcıda geçiş anahtarını oluşturmak için Oluştur ve oturum aç adımından itibaren on dakikanız vardır. Bundan sonra kurulum kapanır ve yönetici geçiş anahtarı olmadan var olur. Aşağıda yeniden denemeler altında açıklandığı gibi bir operatörün yardım etmesi gerekir.

Bundan böyle ilk yönetici o geçiş anahtarıyla oturum açar. Tam yetkili bir yöneticinin tek başına yazılan parolası asla bir oturum açmaz: Oturum açma hizmeti ikinci doğrulama isteğiyle yanıt verir. Bu, tasarımın bir özelliğidir ve geçiş anahtarının önemli olmasının nedenidir. Kaybedilen bir geçiş anahtarı, kaybedilen bir giriş yolu demektir; bu nedenle ilk gün bir telefona veya güvenlik anahtarına ikinci bir geçiş anahtarı ekleyin.

Daha sonra kişiler kuruluma kuruluşun izin verdiği şekilde bir geçiş anahtarıyla, Google ile, GitHub ile veya kendi şirketlerinin oturum açma yöntemiyle oturum açar.

Kod Anlamı Ne yapılmalı
PASSKEY_UNSUPPORTED Bu tarayıcı geçiş anahtarı oluşturamıyor. Hiçbir şey ayarlanmadı. Sayfayı aynı bilgisayarda geçiş anahtarlarını destekleyen bir tarayıcıda açın.
PASSKEY_CANCELLED İstem kapatıldı veya zamanında hiçbir şey seçilmedi. Hiçbir şey gönderilmedi. Düğmeye tekrar basın.

İlk Bugün (Today) sayfası

Konsol Bugün sayfasında açılır ve ilk gün üzerindeki neredeyse her şey boştur. Her boş alan orada neyin görüneceğini söyler ve onu başlatan düğmeyi verir; dolayısıyla "Yönetici gerekiyor" alanı, yanında Kişileri davet et düğmesiyle birlikte, kişiler katıldığında isteklerin orada bekleyeceğini belirtir. Kurulum kontrol listesi, adımlarından kaçının (herhangi bir sırayla) tamamlandığını söyler. Tek gerçek geçmiş olan kurulumun kendisi zaten "Neler değişti" altındadır: Kurulum ayarlandı ve ilk yöneticinin geçiş anahtarı oluşturuldu.

Her şey yeniyken Bugün
Her şey yeniyken Bugün
İlk günde Bugün sayfası. Her boş alan orada neyin görüneceğini ve nasıl başlatılacağını söyler ve "Neler değişti" alanı zaten kurulumun kendisini barındırır.

Kimse oturum açmadan önce yapılması gereken altı şey

Kimse oturum açmadan önce altı şey sayfası, kişiler davet edilmeden önce nelerin geçerli olması gerektiğini listeler. Bu bir sihirbaz değildir. Bunları istediğiniz sırayla yapın; sayfa bunları sayar ("Altı taneden üçü tamam").

Öğe Bunu geçerli kılan durum
Lisans Bir Enterprise lisansı içe aktarıldı. Bölüm 2.13, Lisanslar. Community sürümü lisans gerektirmez.
Adres ve sertifika Genel adres, zinciri eksiksiz olan bir sertifikayla yanıt verir.
Yedeklemeler Yazılabilir bir hedefle birlikte bir yedekleme zamanlaması ayarlandı.
Şirket oturum açma yöntemi Bağlandı ve test edildi. O zamana kadar kişiler geçiş anahtarlarını kullanır.
Posta Bir posta sunucusu ayarlandı. O zamana kadar davetiyeler gönderilemez.
YZ modeli Bir YZ (yapay zeka) modeli: Bir kuruluş model anahtarı veya kendi donanımınızdaki bir model. O zamana kadar asistan bekler. Bölüm 2.14, YZ sağlayıcıları ve modelleri.

Altısı da geçerli olduğunda Kişileri davet et açılır.

Aynı sayfa, kişiler oturum açtıktan sonra nelerin sabitleneceğini her birinin nedeniyle birlikte listeler: Adreslerdeki kısa ad, verilerin tutulduğu yer ve anahtar saklayıcısı (anahtarlar bir yazılım saklayıcısından donanıma taşınabilir ancak asla geri dönemez). Kuruluşun adı da değişebilmesine rağmen kontrol etmeye değer olduğu için listelenir.

Kuruluşun bir modeli olana kadar Nexus kimsenin YZ isteğine yanıt vermez. Bir kurulumun arkasında paylaşılan bir anahtar ve yedek bir seçenek yoktur; bu nedenle model anahtarı olmayan bir kuruluş, yöneticiye ne eklemesi gerektiğini söyleyen açık bir ret yanıtı alır.

Kimse oturum açmadan önce altı şey
Kimse oturum açmadan önce yapılması gereken altı şey
İstenilen sırayla, sözcüklerle sayılan altı kontrol. Kişiler oturum açtıktan sonra sabitlenen seçimler nedenleriyle birlikte listelenir, böylece kimse sonradan sürprizle karşılaşmaz.

Şirket oturum açma yöntemi

Çoğu kuruluş, kişilerin zaten sahip oldukları hesaplarla oturum açmasını ister. Şirket oturum açma sayfasında kimlik sağlayıcınızı bağlayın: Community sürümünde OIDC (OpenID Connect) üzerinden veya Enterprise sürümünde OIDC ya da SAML (Security Assertion Markup Language) üzerinden.

  1. Sağlayıcıyı ve kullandığı standardı seçin.
  2. Kimlik sağlayıcınızın size verdiği uygulama kimliğini ve uygulama gizli anahtarını girin. Gizli anahtar, siz kaydettikten sonra bir daha asla gösterilmez.
  3. Kimlerin oturum açabileceğini belirtin, örneğin @harrow.example adresine sahip herkes.
  4. Oturum açmayı test et düğmesine basın ve kendiniz olarak oturum açın. Sonuç, kimin oturum açtığını ve sağlayıcının ne gönderdiğini sözcüklerle ifade eder.
  5. Kaydedin.

Community sürümü, kuruluş için tek bir şirket oturum açma yöntemi alır. Enterprise sürümü zorunlu kılma ve dizin eşitleme özelliklerini ekler. Zorunlu kılma, parolaları kapatır; böylece herkes şirket oturum açma yöntemini kullanmak zorunda kalır ve bir parola denemesi SSO_REQUIRED ve doğru giriş yoluna yönlendiren bir düğmeyle reddedilir. Dizin eşitleme, her 15 dakikada bir dizininizdeki kişileri ve grupları kopyalar ve adlandırılmış bir gruptan yöneticiler oluşturabilir.

Şirket oturum açma yöntemi yanıt vermeyi durdurduğunda, zaten oturum açmış olan kişiler oturumları açık kalmaya devam eder ve yeni bir oturum açma işlemi IDP_UNREACHABLE (503) ile reddedilir. Bir yönetici bu durumda kasadaki acil durum yönetici oturum açma bilgisini kendi geçiş anahtarıyla birlikte kullanabilir. Her kullanım denetim günlüğüne yazılır, her yöneticiye duyurulur ve dört saat sonra veya şirket oturum açma yöntemi geri geldiğinde sona erer.

Kimlik sağlayıcınızı bağlayın
Kimlik sağlayıcınızı bağlayın
Test içeren şirket oturum açma yöntemi. Sağlayıcı, küçük puntolarla standart ve kimse ona güvenmeden önce sonucu sözcüklerle yazılan bir oturum açma testi.

İnsanları davet edin

Posta ayarlandıktan sonra Kişiler sayfasından kişileri davet edin. Her biri için e-posta adresini ve bir rol verin:

  • Üye, kuruluşun sahip olduğu her şeyi kullanır ve hiçbir ayarı değiştirmez.
  • Yönetici ayrıca kişileri, modelleri, bütçeleri ve ayarları yönetir.

Bir davetiye 7 gün geçerlidir. Kişi davetiyeyi açar, kendisini kimin davet ettiğini, rolünü ve neleri göreceğini görür ve oturum açar. İlk oturum açışında ikinci bir doğrulama istenir.

Davet edilen üyeler konsolda oturum açar ve günlük işlerini orada yaparlar: Rollerinin izin verdiği ölçüde Bugün sayfası, asistan, ekip sohbeti, dosyalar ve arama, not defterleri, aracılar ve iş akışları. Yöneticiler yönetim sayfalarını da görür. Bir yönetici sayfasını açan üye, "Yönetici değil" sayfasıyla karşılaşır. Bu sayfa ayarları salt okunur olarak gösterir, nedenini açıklar ve bir yöneticiden istemeyi teklif eder.

Bir iş arkadaşını davet et
Bir iş arkadaşını davet et
Bir davetiye, kişi gelmeden önce rolünü (Üye veya Yönetici) seçer ve kısa bir not taşıyabilir.

Kayıtlar onay gerektirir

Kişiler kendileri kaydolarak da katılmak isteyebilir. Bir kurulumda, yabancı birinin kaydolması çalışan bir hesap oluşturmaz. nexus-auth bunu SIGNUP_REQUIRES_APPROVAL (403) ile reddeder ve bir yöneticinin onayı için bekletir.

Adverant'ın barındırılan hizmetinde iki kayıt kontrolü daha vardır ve bunlar her kurulumda kapalıdır; bunları açacak bir değer de yoktur. İnternet CAPTCHA'sı her kayıtta internet gerektirir. Kayıt ağı taraması ise kurulumun taşımadığı lisanslı bir coğrafi konum veritabanı gerektirir. Onay, kurulumun geçiş kapısıdır.

Yeniden denemeler, süresi dolmuş kodlar ve diğer retler

İlk çalıştırmadaki her ret yanıtı ne olduğunu, geçerli olduğu durumlarda hiçbir şeyin değişmediğini ve bundan sonra ne yapılacağını söyler.

Kod Durum Ne zaman Ne yapılmalı
CLAIM_CODE_EXPIRED 410 30 dakika geçti. Hiçbir şey sahiplenilmedi ve hiçbir şey değişmedi. nexusctl claim-code --administrator <email> ile yeni bir kod oluşturun, ardından Yeni bir kodum var düğmesine basın.
CLAIM_FINGERPRINT_MISMATCH 403 Gönderilen parmak izi bu kuruluma ait değil. Durun. Adresi ve sertifikayı kontrol edin.
TRANSITION_NOT_PERMITTED 409 Zaten gerçekleşmiş bir adım tekrar istendi: Sahiplenilmiş bir kurulumda sahiplenme işlemi veya ikinci kez ilk yönetici oluşturma. Konsolda oturum açın; diğer herkesi ilk yönetici ekler.
TRANSITION_NOT_PERMITTED 409 Bekleyen bir ilk yöneticinin olmadığı bir tarayıcıdan veya on dakikası geçtikten sonra geçiş anahtarı adımı. Aşağıya bakın.
RATE_LIMITED 429 İlk çalıştırma sayfalarında bir dakikada çok fazla deneme yapıldı. Hiçbir şey gönderilmedi. Sayfanın verdiği saniye kadar bekleyin, ardından tekrar deneyin.

Deneme hakkı kalmayan bir kod "Bu kodun deneme hakkı kalmadı" mesajını verir. Süresi dolmuş bir kodda olduğu gibi yeni bir kod oluşturun. Bunu yalnızca kümeye erişimi olan biri yapabilir ki zaten amaç da budur.

İlk çalıştırma sayfaları toplamda dakikada 20 deneme kabul eder. Bu denemeleri siz yapmadıysanız ağınızdaki başka biri sayfayı deniyordur ve bunu bilmekte fayda vardır.

Geçiş anahtarı adımı kaçırıldığında

İlk yönetici oluşturulduysa ancak on dakika içinde geçiş anahtarı oluşturulmadıysa veya tarayıcı kapatıldıysa, yönetici oturum açma yolu olmadan var olur. Geçiş anahtarı adımı, "Bu tarayıcıda ilk yöneticiyi on dakikadan daha uzun süre önce oluşturduysanız bir operatöre danışın: Yönetici mevcut ve henüz geçiş anahtarı yok" sözleriyle birlikte TRANSITION_NOT_PERMITTED yanıtını verir. O noktada sahiplenme hakkı kullanılmıştır, dolayısıyla yeni bir sahiplenme kodu işe yaramaz. Başka bir şey denemeden önce kurulumu çalıştıran operatöre danışın.

Tarayıcı sahiplenmeyi kaybettiğinde

Sahiplenme bilgisi, onu gerçekleştiren tarayıcıda, sayfanın okuyamadığı bir çerezde yaşar. O tarayıcı sahiplenme ile ilk yönetici adımı arasında bunu kaybederse (örneğin kapatılan bir gizli pencerede), ilk yönetici formu elle yapıştırılan sahiplenme dosyasını ve kurulum gizli anahtarını da kabul eder.

Aoife geçiş anahtarını aldıktan sonra Tomás terminalini kapattı. Sahiplenme sayfası kapalıydı, ilk yönetici mevcuttu ve içeri giden diğer her yol artık onun üzerinden geçiyordu.