کتابخانه‌ی استاندارد · شبکه

سرور اس‌اس‌اچ sshd

کارساز SSH با ورود با گذرواژه و کلید عمومی، فرمان، پوسته و SFTP، نوشته‌شده با سلام.

واردسازی سرور اس‌اس‌اچ

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

این بسته یک کارساز SSH به زبان سلام است. یک پیکربندی بسازید، کاربرانی را که می‌توانند وارد شوند اضافه کنید، گوش دادن و بعد خدمت را صدا بزنید، و یک کارخواه معمولی مثل OpenSSH یا بسته‌ی اس اس اچ (ssh) می‌تواند وصل شود، با گذرواژه یا کلید عمومی وارد شود، فرمانی اجرا کند، پوسته‌ی تعاملی باز کند و با SFTP پرونده جابه‌جا کند. به OpenSSH روی دستگاه نیازی نیست.

این بسته تنظیمات و چرخه‌ی زندگی کارساز را نگه می‌دارد: روی چه چیزی گوش بدهد، چه کسی وارد شود و کاربر واردشده چه کارهایی بتواند بکند. خودِ پروتکل، یعنی تبادل کلید، رمزگذاری و کانال‌ها، را همان بسته‌ی اس اس اچ (ssh) که کارخواه به کار می‌برد انجام می‌دهد.

پیش از به‌کار بردن بدانید:

  • کلید میزبان بگذارید. کارخواه با کلید میزبان به کارساز اعتماد می‌کند. با پرونده کلید میزبان کارساز یک کلید خصوصی OpenSSH را می‌خواند و در هر بار شروع همان هویت را نگه می‌دارد. بدون آن کلید از دانه کلید میزبان ساخته می‌شود و وقتی آن هم خالی است از دانه‌ای که در کتابخانه است و همه می‌توانند آن را بخوانند، پس روی کارساز واقعی هیچ‌وقت هر دو را خالی نگذارید.
  • کلیدهای عمومی در پرونده کلیدهای مجاز فهرست می‌شوند، در هر خط یک کلید عمومی OpenSSH. برخلاف sshd این فهرست مشترک است: کلیدی که در آن باشد می‌تواند به‌عنوان هر کاربر در کاربران وارد شود، پس برای هر سرویس کارساز و پرونده‌ی جدا بگیرید. وقتی کلید کافی است اجازه گذرواژه را خاموش کنید.
  • هر کاربر یک نام، یک گذرواژه و یک خانه دارد. خانه پوشه‌ای زیر ریشه است و جلسه‌ی SFTP آن کاربر از همان‌جا شروع می‌شود. همه‌ی کاربرها یک ریشه مشترک دارند.
  • کلیدهای اجازه: اجازه اجرای فرمان برای فرمان تکی، اجازه پوسته برای پوسته‌ی تعاملی و اجازه اس‌اف‌تی‌پی برای انتقال پرونده. اجازه پوسته به‌تنهایی جلوی اجرای فرمان را نمی‌گیرد، چون فرمان با /bin/sh -c و با اختیارات فرایند کارساز اجرا می‌شود؛ برای کارسازی که فقط پرونده جابه‌جا می‌کند اجازه اجرای فرمان را هم خاموش کنید.
  • اتصال‌ها یکی پس از دیگری خدمت می‌گیرند و نخستین خواندن هر اتصال محدودیت زمانی ندارد، پس کارخواهی که وصل شود و ساکت بماند، یا یک جلسه‌ی طولانی، همه‌ی پشت سرش را منتظر نگه می‌دارد. اگر غریبه‌ها به کارساز می‌رسند آن را پشت چیزی بگذارید که اتصال‌های بیکار را محدود می‌کند.
  • اگر پرونده کلید میزبان فایلی را نشان بدهد که وجود ندارد، گوش دادن نادرست برمی‌گرداند، پس غلط تایپی بی‌صدا کلید داخلی را نمی‌گذارد. فایلی که هست اما خوانده نمی‌شود هنوز به دانه برمی‌گردد.

کاربرها، پیش‌فرض‌ها و یک درگاه آزاد

پیکربندی نو روی همه‌ی رابط‌ها در درگاه ۲۲ گوش می‌دهد و گذرواژه، کلید عمومی، فرمان، پوسته و SFTP را مجاز می‌داند. افزودن کاربر یک کاربر اضافه می‌کند؛ اگر خانه را ندهید / است. گوش دادن روی نشانی خودی با درگاه ۰ می‌گذارد سیستم درگاهی برگزیند و درگاه می‌گوید کدام را؛ پس این برنامه بدون شبکه و بدون برخورد با یک کارساز SSH واقعی اجرا می‌شود.

sshd-users.salam
واردسازی سرور اس‌اس‌اچ

تابع ریشه:
    ناپایا پیکربندی := سرور اس‌اس‌اچ.پیکربندی نو()
    سرچاپ پیکربندی.درگاه، پیکربندی.اجازه گذرواژه، پیکربندی.اجازه کلید عمومی، پیکربندی.اجازه پوسته
    پیکربندی.میزبان = "127.0.0.1"
    پیکربندی.درگاه = ۰
    پیکربندی.ریشه = "/srv/files"
    پیکربندی.اجازه پوسته = نادرست
    پیکربندی.پیام خوش‌آمد = "authorized use only"
    سرور اس‌اس‌اچ.افزودن کاربر(پیکربندی، "alice"، "s3cret"، "/home/alice")
    سرور اس‌اس‌اچ.افزودن کاربر(پیکربندی، "bob"، "hunter2")
    هر کاربر در پیکربندی.کاربران:
        سرچاپ کاربر.نام، کاربر.خانه
    پایان
    ناپایا سرور := سرور اس‌اس‌اچ.جدید(پیکربندی)
    سرچاپ سرور اس‌اس‌اچ.گوش دادن(سرور)
    سرچاپ سرور اس‌اس‌اچ.درگاه(سرور) بزرگتر ۰
    سرور اس‌اس‌اچ.بستن(سرور)
    سرچاپ سرور اس‌اس‌اچ.نسخه پیش فرض
پایان
خروجی22 true true true alice /home/alice bob / true true SSH-2.0-SalamServer_1.0

وقتی درگاه بسته نشود گوش دادن نادرست برمی‌گرداند و بستن آن را دوباره آزاد می‌کند. پیام خوش‌آمد پیش از ورود به کارخواه نشان داده می‌شود.

فقط با کلید عمومی پرونده پخش کنید

کارسازی که برای دریافت استقرار ساخته شده نباید گذرواژه بپذیرد و نباید پوسته بدهد. نمونه هویتش را از یک پرونده‌ی کلید میزبان می‌خواند، فقط کلیدهای فهرست‌شده در پرونده کلیدهای مجاز را راه می‌دهد و پوسته نمی‌دهد. فرمان‌ها همچنان مجازند؛ برای کارسازی که فقط پرونده جابه‌جا می‌کند اجازه اجرای فرمان را هم خاموش کنید.

sshd-serve.salam
واردسازی سرور اس‌اس‌اچ

تابع ریشه:
    ناپایا پیکربندی := سرور اس‌اس‌اچ.پیکربندی نو()
    پیکربندی.درگاه = ۲۲۲۲
    پیکربندی.ریشه = "/srv/files"
    پیکربندی.پرونده کلید میزبان = "/etc/deploy/host_key"
    پیکربندی.پرونده کلیدهای مجاز = "/etc/deploy/authorized_keys"
    پیکربندی.اجازه گذرواژه = نادرست
    پیکربندی.اجازه پوسته = نادرست
    سرور اس‌اس‌اچ.افزودن کاربر(پیکربندی، "deploy"، ""، "/")
    ناپایا سرور := سرور اس‌اس‌اچ.جدید(پیکربندی)
    اگر وارونه سرور اس‌اس‌اچ.گوش دادن(سرور):
        سرچاپ "گوش دادن روی درگاه ممکن نشد"، پیکربندی.درگاه
        برگشت ۱
    پایان
    سرچاپ "کارساز اس‌اس‌اچ روی درگاه"، سرور اس‌اس‌اچ.درگاه(سرور)
    سرور اس‌اس‌اچ.خدمت(سرور)
    برگشت ۰
پایان

این برنامه تا وقتی متوقف نشود ادامه می‌دهد، پس این‌جا فقط بررسی می‌شود. با ssh -p 2222 deploy@host یا با اتصال و یک کلید از بسته‌ی اس اس اچ به آن وصل شوید.

کدام تابع برای کدام کار

کارابزار
شروع از پیش‌فرض‌هاپیکربندی نو و بعد گذاشتن فیلدهای پیکربندی
مجاز کردن ورود یک کاربرافزودن کاربر
ساختن کارسازجدید
باز کردن درگاهگوش دادن و بعد درگاه برای خواندن آن
خدمت به کارخواه‌ها تا توقفخدمت
خدمت دقیقاً به یک اتصالیک‌بار خدمت
توقف و آزاد کردن درگاهبستن

گونه‌ها

کاربر User

ساختار کاربر
کاربری که می‌تواند به کارساز وارد شود.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام ورود.
گذرواژهpasswordرشته = ""گذرواژه برای ورود با گذرواژه.
خانهhomeرشته = "/"پوشه‌ی زیر ریشه که کاربر از آن‌جا شروع می‌کند؛ پیش‌فرض /.
sshd-Config.salam
واردسازی سرور اس‌اس‌اچ

تابع ریشه:
    ناپایا پیکربندی := سرور اس‌اس‌اچ.پیکربندی نو()
    سرچاپ پیکربندی.میزبان، پیکربندی.درگاه، پیکربندی.نسخه سرور برابر سرور اس‌اس‌اچ.نسخه پیش فرض
    سرچاپ پیکربندی.اجازه گذرواژه، پیکربندی.اجازه کلید عمومی
    سرچاپ پیکربندی.اجازه اجرای فرمان، پیکربندی.اجازه پوسته، پیکربندی.اجازه اس‌اف‌تی‌پی
    سرچاپ پیکربندی.ریشه، پیکربندی.پیام خوش‌آمد برابر ""، پیکربندی.کاربران.طول()
    سرور اس‌اس‌اچ.افزودن کاربر(پیکربندی، "alice"، "s3cret"، "/home/alice")
    سرور اس‌اس‌اچ.افزودن کاربر(پیکربندی، "bob"، "hunter2")
    هر کاربر در پیکربندی.کاربران:
        سرچاپ کاربر.نام، کاربر.گذرواژه.طول()، کاربر.خانه
    پایان
پایان
خروجی0.0.0.0 22 true true true true true true . true 0 alice 6 /home/alice bob 7 /

پیکربندی Config

ساختار پیکربندی
پیکربندی یک کارساز SSH.
نامانگلیسیگونهتوضیح
میزبانhostرشته = "0.0.0.0"نشانی‌ای که روی آن گوش داده می‌شود؛ 0.0.0.0 یعنی همه‌ی رابط‌ها.
درگاهportصحیح = 22درگاهی که روی آن گوش داده می‌شود؛ پیش‌فرض ۲۲ است و ۰ می‌گذارد سیستم یکی را برگزیند.
نسخه سرورserver_versionرشتهرشته‌ی نسخه که به کارخواه‌ها فرستاده می‌شود؛ پیش‌فرض نسخه پیش فرض.
پرونده کلید میزبانhost_key_fileرشته = ""مسیر کلید خصوصی OpenSSH که هویت کارساز است.
پرونده کلیدهای مجازauthorized_keys_fileرشته = ""مسیر پرونده‌ی کلیدهای عمومی‌ای که می‌توانند وارد شوند.
اجازه گذرواژهallow_passwordمنطقی = درستمی‌گذارد کاربرها با گذرواژه وارد شوند؛ پیش‌فرض روشن.
اجازه کلید عمومیallow_publickeyمنطقی = درستمی‌گذارد کاربرها با کلید عمومی وارد شوند؛ پیش‌فرض روشن.
ریشهrootرشته = "."پوشه‌ای که کارخواه‌ها در SFTP آن را / می‌بینند و پوشه‌ی کاری فرمان‌ها.
اجازه اجرای فرمانallow_execمنطقی = درستمی‌گذارد کاربرها یک فرمان تکی اجرا کنند.
اجازه پوستهallow_shellمنطقی = درستمی‌گذارد کاربرها پوسته‌ی تعاملی باز کنند.
اجازه اس‌اف‌تی‌پیallow_sftpمنطقی = درستمی‌گذارد کاربرها با SFTP پرونده جابه‌جا کنند.
پیام خوش‌آمدbannerرشته = ""پیامی که پیش از ورود به کارخواه نشان داده می‌شود؛ خالی یعنی هیچ.
دانه کلید میزبانhost_seedرشته = ""متنی که وقتی پرونده کلید میزبان نیست کلید میزبان از آن ساخته می‌شود؛ یک متن همیشه یک کلید می‌دهد.
کاربرانusersوکتور<کاربر>کاربرهایی که می‌توانند وارد شوند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Config.salam

سرور Server

ساختار سرور
یک کارساز SSH در حال اجرا.
نامانگلیسیگونهتوضیح
پیکربندیconfigپیکربندیپیکربندی‌ای که کارساز با آن ساخته شده؛ بعد از گوش دادن درگاهش همان درگاه واقعی است.
شنوندهlistenerتی سی پی.سرورسوکت شنونده.
در حال اجراrunningمنطقی = نادرستبعد از موفقیت گوش دادن درست است و تا صدا زدن بستن می‌ماند.
sshd-Server.salam
واردسازی سرور اس‌اس‌اچ

تابع ریشه:
    ناپایا پیکربندی := سرور اس‌اس‌اچ.پیکربندی نو()
    پیکربندی.میزبان = "127.0.0.1"
    پیکربندی.درگاه = ۰
    ناپایا سرور := سرور اس‌اس‌اچ.جدید(پیکربندی)
    سرچاپ سرور.در حال اجرا
    سرچاپ سرور اس‌اس‌اچ.گوش دادن(سرور)، سرور.در حال اجرا
    سرچاپ سرور اس‌اس‌اچ.درگاه(سرور) بزرگتر ۰
    سرور اس‌اس‌اچ.بستن(سرور)
    سرچاپ سرور.در حال اجرا
پایان
خروجیfalse true true true false

پایاها و متغیرها

نسخه پیش فرض DefaultVersion

پایا نسخه پیش فرض: رشته = "SSH-2.0-SalamServer_1.0"
رشته‌ی نسخه که کارساز به کارخواه‌ها اعلام می‌کند، SSH-2.0-SalamServer_1.0.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Config.salam

تابع‌ها

پیکربندی نو NewConfig

تابع پیکربندی نو(): پیکربندی
پیکربندی با مقدارهای پیش‌فرض: درگاه ۲۲، گذرواژه و کلید مجاز، فرمان و پوسته و SFTP مجاز، بدون کاربر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Config.salam

جدید New

تابع جدید(cfg: پیکربندی): سرور
از یک پیکربندی کارساز می‌سازد. هنوز گوش نمی‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Server.salam

گوش دادن Listen

تابع گوش دادن(srv &: سرور): منطقی
درگاه را باز می‌کند؛ اگر نتواند آن را ببندد نادرست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Server.salam

بستن Close

تابع بستن(srv &: سرور)
کارساز را متوقف می‌کند و درگاه را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Server.salam

درگاه Port

تابع درگاه(srv: سرور): صحیح
درگاهی که کارساز روی آن گوش می‌دهد؛ وقتی پیکربندی ۰ بود، بعد از گوش دادن درگاه واقعی است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Server.salam

افزودن کاربر AddUser

تابع افزودن کاربر(cfg &: پیکربندی، name: رشته، password: رشته، home: رشته = "/")
کاربری با نام، گذرواژه و پوشه‌ی خانه اضافه می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Config.salam

یک‌بار خدمت ServeOnce

تابع یک‌بار خدمت(srv &: سرور): منطقی
منتظر یک اتصال می‌ماند و تا رفتن کارخواه به آن خدمت می‌دهد؛ اگر درگاه باز نباشد یا پذیرفتن شکست بخورد نادرست برمی‌گرداند.
sshd-Serve.salam
واردسازی سرور اس‌اس‌اچ
واردسازی محیط

تابع ریشه:
    ناپایا پیکربندی := سرور اس‌اس‌اچ.پیکربندی نو()
    پیکربندی.درگاه = ۲۲۲۲
    پیکربندی.ریشه = "/srv/files"
    پیکربندی.میزبان = "127.0.0.1"
    پیکربندی.اجازه پوسته = نادرست
    پیکربندی.اجازه اجرای فرمان = نادرست
    سرور اس‌اس‌اچ.افزودن کاربر(پیکربندی، "alice"، محیط.دریافت("SSH_PASSWORD"))
    ناپایا سرور := سرور اس‌اس‌اچ.جدید(پیکربندی)
    اگر وارونه سرور اس‌اس‌اچ.گوش دادن(سرور):
        برگشت ۱
    پایان
    رسیدگی شد := سرور اس‌اس‌اچ.یک‌بار خدمت(سرور)
    سرچاپ "یک اتصال خدمت شد:"، رسیدگی شد
    سرور اس‌اس‌اچ.خدمت(سرور)
    سرور اس‌اس‌اچ.بستن(سرور)
    برگشت ۰
پایان

خدمت Serve

تابع خدمت(srv &: سرور)
یکی پس از دیگری به اتصال‌ها خدمت می‌دهد تا در حال اجرا نادرست شود یا شنونده از کار بیفتد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sshd-Serve.salam