Skip to main content
CID222 Docs
YönetimAyarlar

Parola teslimatı

Parola sıfırlama bağlantısının kullanıcıya nasıl ulaşacağını seçin — bir yönetici elden verir, kendi posta sunucunuz gönderir ya da EmailJS gönderir.

  • Sürüm: 0.4
  • Tür: görev

CID222'de parola sıfırlama her zaman aynı nesnedir: sınırlı ömürlü, tek kullanımlık bir bağlantı. Ayarlar → Parola teslimatı, bu bağlantının ihtiyacı olan kişiye nasıl ulaşacağına karar verir — bir yönetici panodan kopyalar, kendi posta sunucunuz gönderir ya da barındırılan bir EmailJS şablonu gönderir.

Neye ihtiyacım var?

Lisans
Any
Rol
superadmin

Ön koşullar

  • superadmin olarak oturum açmalısınız. Bu, API'nin admin_user yerine superadmin ile sınırladığı birkaç bölmeden biridir.
  • Posta sunucusu yolu için: cihazın erişebileceği bir SMTP aktarıcısının adresi ve portu ve kabul edeceği bir gönderen adresi.
  • Özel olarak imzalanmış bir aktarıcı için: düzenleyici CA sertifikası, PEM biçiminde.
  • EmailJS için: cihazda ortam değeri olarak yapılandırılmış bir EmailJS servisi, açık anahtarı ve sıfırlama şablonu ve dışarıya internet erişimi.
  • Cihaz, isteklerin geldiği addan farklı bir adla yayımlanıyorsa kullanıcıların erişebileceği bir pano adresi.

Üç kanal

KanalSayfanın adlandırmasıSıfırlamada ne olur
admin_linkAdministrator hands out the link (no mail)Hiçbir şey gönderilmez. Bir yönetici kullanıcının kaydında bağlantıyı üretir ve elden verir. Kullanıcının kendi başlattığı Forgot password akışı, kullanıcıya bir yöneticiye başvurmasını söyleyen bir iletiyle yanıtlanır ve hiçbir belirteç üretilmez.
smtpYour own mail server (SMTP)Cihaz postayı kendisi oluşturur ve aktarıcınız üzerinden gönderir.
emailjsEmailJS (hosted, needs outbound internet)Cihaz EmailJS'i çağırır ve sizin şablonunuzu o işler. Posta gövdesi CID222'nin değil, sizindir.

Biri seçim yapana kadar ortam karar verir: yapılandırılmışsa EmailJS, aksi hâlde yönetici bağlantısı. Sayfa bunu söyler: Nothing has been chosen yet, so the environment is deciding. Kaydetmek seçimi açık hâle getirir.

Bağlantının kendisi her durumda aynıdır: 64 karakterlik, tek kullanımlık bir belirteç; PASSWORD_RESET_EXPIRES_MINUTES dakika geçerlidir — varsayılan 60. Yalnızca özeti saklanır, kullanılması onu temizler ve yeni bir bağlantı üretmek öncekini geçersiz kılar.

Warning

Dizin tabanlı hesaplar burada hiç sıfırlanamaz. Cihaz şu ifadeyle reddeder: This account is managed by your directory (AD/LDAP). Its password must be reset in the directory — burada üretilecek bir bağlantı, oturum açmanın hiç denetlemediği bir parola belirlerdi. Bu kullanıcıları bunun yerine Directory self-service page adresine yönlendirin.

Bağlantıyı kendiniz elden verin

Varsayılan budur ve hiçbir altyapı gerektirmeyen tek kanaldır.

Kanalı seçin

Ayarlar → Parola teslimatı öğesini seçin, Delivery channel alanını Administrator hands out the link (no mail) yapın ve Kaydet öğesini seçin.

Bir bildirim Password delivery settings saved der.

Bir kullanıcı için bağlantı üretin

Kiracılar sayfasını açın, hesabı bulun ve Şifreyi sıfırla öğesini seçin.

Pencere, kopyalama düğmesiyle birlikte tek kullanımlık bir bağlantı gösterir ve şunu belirtir: Expires …. Generating a new link invalidates any previous one.

Ayrı bir kanaldan iletin

Bağlantıyı kopyalayın ve kullanıcıya güvendiğiniz bir kanaldan verin.

Pencere bunun neden önemli olduğunu açıkça söyler: No email is sent, so deliver it securely: anyone with the link can set the password until it expires or is used.

Kendi posta sunucunuz üzerinden gönderin

Ağdan yalıtılmış bir cihaz zorunlu olarak postasız değildir — kapalı ağların çoğu bir iç aktarıcı çalıştırır ve cihazı ona yönlendirmek, kendi kendine sıfırlamayı geri getirir.

Kanalı seçin

Delivery channel alanını Your own mail server (SMTP) yapın.

Bir Mail server kartı belirir.

Aktarıcı adresini girin

Host ve Port alanlarını ayarlayın — örneğin mail.example.corp ve 587.

Kanalın teslimat yapabilmesi için bir gönderen adresiyle birlikte ikisi de zorunludur.

Şifrelemeyi seçin

Encryption alanını STARTTLS (required), TLS on connect ya da None yapın.

STARTTLS denenmez, zorunlu kılınır: onu sunmayan bir sunucuda bağlantı, açık metinle devam etmek yerine başarısız olur.

Kimlik doğrulayın ya da doğrulamayın

Username ve Password alanlarını doldurun ya da Username alanını boş bırakın.

Boş bir kullanıcı adı hiç kimlik bilgisi göndermez; yerel ağdan posta kabul eden bir iç aktarıcının beklediği budur.

Zarfı ayarlayın

From address alanını, isterseniz From name ve Reply-to (optional) alanlarını da ayarlayın.

Bunlar kullanıcının aldığı postada görünür.

Özel olarak imzalanmış bir aktarıcıyı ele alın

Aktarıcınız iç bir CA'dan sertifika sunuyorsa o CA'yı CA certificate (optional) alanına yapıştırın.

Doğrulama böylece zayıflatılmadan başarılı olur. Do not verify the certificate son çaredir: bağlantı şifreli kalır ama karşı tarafta kimin olduğunu hiçbir şey kanıtlamaz.

Test edip kaydedin

Bağlantıyı test et, ardından Kaydet öğesini seçin.

Başarılı bir test Connected to the mail server bildirir. Bağlanır, TLS anlaşması yapar ve kimlik doğrular — hiç posta göndermez.

Sıfırlama bağlantılarını doğru adrese yönlendirin

Pano adresini ayarlayın

Links altında Dashboard address alanını kullanıcılarınızın açtığı URL yapın; örneğin https://cid.example.corp.

Boş bırakıldığında cihaz, her isteğin geldiği adresi kullanır; bu bir cihazda genellikle doğrudur ve yeniden yazan bir vekil sunucunun arkasında yanlıştır.

Dizin kullanıcılarını yönlendirin

Directory self-service page alanını kendi parola sıfırlama portalınız yapın.

Dizin tabanlı hesapların cihazda parolası yoktur; dolayısıyla onlar için tek işe yarar hedef budur.

Kullanıcı ne alır

SMTP kanalında postayı cihaz kendisi oluşturur; Mail language ayarına göre İngilizce ya da Türkçe. İngilizce postanın konusu Reset your password'dür ve şöyle okunur:

Hello name,

Use the link below to set a new password.

The link can be used once and expires in 60 minutes.

If you did not request this, you can ignore this message — your password stays unchanged.

Eylem, Set a new password etiketli bir düğmedir; altında ham bağlantı yinelenir, böylece bağlantıları soyan bir posta istemcisinde bile kopyalanacak bir şey kalır. Şablon düzenleyicisi yoktur.

EmailJS kanalında gövde tümüyle sizin şablonunuzdur. Şablonun to_email, username ve reset_link parametrelerini kullanması gerekir.

Alan başvurusu

Sayfadaki alanNasıl saklanırVarsayılanNotlar
Delivery channelchannelayarsızadmin_link, smtp ya da emailjs. Ayarsız olması ortamın karar vermesi demektir.
Mail languagelocaleenen ya da tr. CID222'nin oluşturduğu postaya uygulanır, EmailJS şablonuna değil.
Hostsmtp_host—SMTP için zorunlu.
Portsmtp_port—SMTP için zorunlu, 1–65535.
Encryptionsmtp_securitystarttlsnone, starttls ya da tls.
Usernamesmtp_username—Boş bırakmak hiç kimlik bilgisi göndermez.
Passwordşifreli sütun—Hiçbir zaman döndürülmez. Kaydederken boş bırakmak saklanan değeri korur; boş bir dize onu temizler.
From addressfrom_address—SMTP için zorunlu.
From namefrom_name—
Reply-to (optional)reply_to—
CA certificate (optional)tls_ca_certificate—PEM, en fazla 16 KB.
Do not verify the certificatetls_reject_unauthorized_disabledkapalı
Dashboard addressreset_url_base—Önce PASSWORD_RESET_URL_BASE, sonra isteğin kaynağına geri düşer.
Directory self-service pagedirectory_reset_url—

EmailJS yalnızca cihaz ortam değerleriyle yapılandırılır — EMAILJS_SERVICE_ID, EMAILJS_PUBLIC_KEY, EMAILJS_RESET_TEMPLATE_ID ve isteğe bağlı olarak EMAILJS_PRIVATE_KEY. EmailJS'e dair hiçbir şey veritabanında saklanmaz ve bu sayfada düzenlenemez.

Saklanan SMTP parolası, JWT_SECRET değerinden türetilen bir anahtarla şifrelenir. Bu gizli anahtarı değiştirmek parolayı çözülemez hâle getirir ve yeniden yazmanız gerekir.

Doğrulama

  1. Bağlantıyı test et öğesini seçin. Connected to the mail server bildirir ve düğmelerin altındaki satır Last test zaman damgası: connected okunur.
  2. Bir test hesabı için sıfırlama başlatın ve postanın Reset your password konusuyla ve çalışan bir bağlantıyla geldiğini doğrulayın.
  3. Olay Günlükleri sayfasını açın. Sıfırlama önce PASSWORD_RESET_LINK_ISSUED, sonra kanalı ve teslimatın başarılı olup olmadığını kaydeden PASSWORD_RESET_DELIVERY ve kullanıcı yeni parolayı belirlediğinde PASSWORD_RESET_COMPLETED yazar. Üçünün hiçbiri belirteci ya da bağlantıyı kaydetmez.
  4. Bağlantıyı izleyin, bir parola belirleyin, sonra aynı bağlantıyı yeniden izleyin. Invalid or expired password reset token ile reddedilir.

Başarısız olursa

Test sonucu, aktarım katmanının kendi ifadesidir; Last test alanında saklanır ve sayfada gösterilir.

  • 502 5.5.1 Command not implemented → STARTTLS seçtiniz ve sunucu yalnızca açık metin konuşuyor. Sessiz bir düşürme yoktur. Güvenilir bir segmentte None kullanın ya da aktarıcıyı düzeltin.
  • self-signed certificate → aktarıcının sertifikası özel olarak imzalanmış ve hiç CA yapıştırmadınız. Onu CA certificate (optional) alanına yapıştırın.
  • Hostname/IP does not match certificate's altnames → TLS açıkken IP ile bağlandınız. Sertifikadaki adı kullanın.
  • Greeting never received → hemen TLS konuşan bir sunucuya karşı None seçtiniz. TLS on connect kullanın.
  • channel_not_usable: smtp_host, from_address (ya da herhangi bir alt kümesi) → bu alanlar boştur. Sayfa bunu formun üzerinde de söyler: This channel cannot deliver yet — missing: ….
  • admin_link_channel → Bağlantıyı test et işlemi, hiçbir şey göndermeyen yönetici bağlantısı kanalında çalıştırıldı. Bu kanalda düğme devre dışıdır.
  • EmailJS üzerinde bir test, hiçbir şeyle iletişim kurmadan başarı bildiriyorsa bu tasarımın kendisidir. EmailJS'in gönderim dışında bir erişilebilirlik denemesi yoktur; dolayısıyla testin dürüstçe iddia edebileceği tek şey yapılandırılmış olmasıdır.
  • Kullanıcı bağlantının yanlış sunucuya gittiğini bildiriyorsa Dashboard address alanını ayarlayın.
  • Sıfırlama tek bir kullanıcı için dizin iletisiyle reddediliyorsa o hesap dizin tabanlıdır. Dizinde sıfırlayın.
  • Yinelenen Forgot password denemeleri Too many requests, please try again later. döndürüyorsa devrede olan hız sınırlayıcıdır. Bekleyin ya da bir yönetici bağlantısı verin.

Note

Kullanıcının başlattığı Forgot password akışı her zaman şunu yanıtlar: If an account with that email exists, a password reset link has been sent. — hesap var olsun ya da olmasın, teslimat çalışsın ya da çalışmasın. Bu bilinçlidir; böylece sayfa hesapları sıralamak için kullanılamaz. Gerçekte ne olduğunu görmek için Olay Günlükleri sayfasına bakın.

Sonraki adımlar

Son güncelleme

Bu sayfada