service-name.config(5) File Formats Manual service-name.config(5)

service-name.config - پرونده تدارک سرویس ConnMan

/var/lib/connman/service-name.config

سرویس‌های ConnMan با پرونده‌هایی موسوم به «پرونده‌های تدارک» (provisioning files) که در مسیر /var/lib/connman/ قرار دارند، پیکربندی می‌شوند. نام‌گذاری این فایل‌ها می‌تواند هر چیزی باشد، به شرط آنکه به پسوند .config ختم شوند. از پرونده‌های تدارک می‌توان برای پیکربندی نقاط دسترسی بی‌سیم امن که به احراز هویت پیچیده نیاز دارند (مانند eduroam)، یا برای نشانی‌های IP ایستا و موارد دیگر استفاده کرد. هر پرونده تدارک می‌تواند به طور همزمان برای چندین سرویس استفاده شود.

فایل پیکربندی از بخش‌ها (گروه‌ها)یی متشکل از جفت‌های کلید-مقدار تشکیل شده است. خطوطی که با «#» آغاز می‌شوند و خطوط خالی به عنوان یادداشت (کامنت) در نظر گرفته می‌شوند. بخش‌ها با یک خط عنوان شامل نام بخش درون «[» و «]» آغاز می‌شوند و به صورت ضمنی با شروع بخش بعدی یا پایان فایل خاتمه می‌یابند. هر جفت کلید-مقدار باید درون یک بخش قرار گیرد.

توضیحات بخش‌ها و کلیدهای دردسترس در ادامه آمده است:

این بخش اختیاری است و می‌تواند برای توصیف خود فایل به کار رود. دو فیلد مجاز برای این بخش عبارتند از:

نام شبکه.
توضیحات شبکه.

هر سرویس تدارک‌دیده‌شده باید با برچسب [service_*] آغاز شود که در آن * با یک نام یکتا در درون فایل جایگزین می‌شود. فیلدهای مجاز عبارتند از:

اجباری. انواعی غیر از ethernet یا wifi پشتیبانی نمی‌شوند.
تنظیمات IPv4 برای سرویس. اگر روی off تنظیم شود، از IPv4 استفاده نخواهد شد. اگر روی dhcp تنظیم شود، از dhcp برای دریافت تنظیمات شبکه استفاده می‌شود. netmask را می‌توان به جای خود ماسک، به عنوان طول ماسک مشخص کرد. هنگام استفاده از IP ایستا، می‌توان از تعیین درگاه (gateway) صرف‌نظر کرد.
تنظیمات IPv6 برای سرویس. اگر روی off تنظیم شود، از IPv6 استفاده نخواهد شد. اگر روی auto تنظیم شود، تنظیمات از شبکه دریافت خواهند شد.
تنظیمات حریم خصوصی IPv6 مطابق با استاندارد RFC3041.
نشانی MAC رابط مورد استفاده. اگر مشخص نشود، نخستین رابط یافت‌شده استفاده خواهد شد. باید در قالب ab:cd:ef:01:23:45 باشد.
نام دستگاه رابط مورد استفاده، مانند eth0. نشانی MAC نسبت به DeviceName اولویت دارد.
فهرستی از کارسازهای نام (DNS) که با کاما از هم جدا شده‌اند.
فهرستی از دامنه‌های جستجوی DNS که با کاما از هم جدا شده‌اند.
فهرستی از کارسازهای زمان (NTP) که با کاما از هم جدا شده‌اند.
نام دامنه مورد استفاده.
کلیدهای زیر تنها برای شبکه‌های بی‌سیم قابل استفاده هستند:
نمایش رشته‌ای از SSID شبکه. اگر فیلد SSID وجود داشته باشد، مقدار فیلد Name نادیده گرفته می‌شود. در صورت عدم وجود فیلد SSID، این فیلد اجباری است.
شناسه SSID: نمایش هگزادسیمال از یک 802.11 SSID. از این قالب برای کدگذاری نویسه‌های ویژه شامل فاصله‌های ابتدا یا انتها استفاده کنید.
عبارت عبور RSN/WPA/WPA2.
نوع امنیت شبکه. مقادیر ممکن عبارتند از: psk (برای WPA/WPA2 PSK)، ieee8021x (برای WPA EAP)، none و wep. در صورت عدم تنظیم، اگر یک نوع EAP پیکربندی شده باشد مقدار پیش‌فرض ieee8021x خواهد بود، اگر عبارت عبور وجود داشته باشد مقدار psk خواهد بود و در غیر این صورت none در نظر گرفته می‌شود.
اگر روی true تنظیم شود، این نقطه دسترسی (AP) مخفی است. در صورت عدم درج یا اگر روی false تنظیم گردد، نقطه دسترسی مخفی نخواهد بود.
کلیدهای زیر برای WPA EAP (زمانی که Security=ieee8021x باشد) استفاده می‌شوند:
نوع EAP مورد استفاده. تنها مقادیر tls، ttls و peap پشتیبانی می‌شوند.
مسیر فایل گواهی مرجع صدور گواهی (CA). تنها قالب‌های PEM و DER پشتیبانی می‌شوند.
مسیر فایل کلید خصوصی. تنها قالب‌های PEM، DER و PFX پشتیبانی می‌شوند.
عبارت عبور کلید خصوصی.
در صورت تعیین، از fsid کلید خصوصی به عنوان عبارت عبور استفاده می‌شود و مقدار فیلد PrivateKeyPassphrase نادیده گرفته خواهد شد.
رشته شناسه (هویت) برای EAP.
رشته شناسه ناشناس برای EAP.
زیررشته‌ای که باید با موضوع (subject) گواهی کارساز احراز هویت برای EAP مطابقت داده شود.
رشته‌ای از مقادیر جداشده با نقطه‌ویرگول که باید با نام موضوع جایگزین (alternative subject name) گواهی کارساز احراز هویت برای EAP مطابقت داشته باشد.
محدودیت برای نام دامنه کارساز. در صورت تنظیم، این FQDN به عنوان شرط تطابق پسوند برای گواهی کارساز احراز هویت EAP استفاده می‌شود.
این FQDN به عنوان شرط تطابق کامل برای گواهی کارساز احراز هویت EAP استفاده می‌شود.
نوع احراز هویت درونی برای EAP=tls یا EAP=ttls. پیشوند EAP- را قبل از مقدار قرار دهید تا استفاده از روش احراز هویت مبتنی بر EAP مشخص شود (تنها باید با EAP=ttls به کار رود).

این یک فایل پیکربندی برای شبکه‌های eduroam است. این فایل می‌تواند به عنوان نمونه در مسیر /var/lib/connman/eduroam.config قرار گیرد. تنظیمات دقیق دانشگاه شما ممکن است متفاوت باشد.

[service_eduroam]
Type = wifi
Name = eduroam
EAP = peap
Phase2 = MSCHAPV2
CACertFile = /etc/ssl/certs/UNIV_CA.crt

این یک فایل پیکربندی برای شبکه‌ای است که سرویس‌های EAP-TLS، EAP-TTLS و EAP-PEAP را فراهم می‌کند. شناسه‌های SSID مربوطه به ترتیب tls_ssid، ttls_ssid و peap_ssid هستند و نام فایل می‌تواند /var/lib/connman/complex.config باشد.

لطفاً توجه داشته باشید که مدخل SSID برای SSID با کدگذاری هگزادسیمال است (مانند «"SSID = 746c735f73736964"»). اگر شناسه SSID شما نویسه نامتعارفی ندارد، باید به جای آن از مدخل Name استفاده کنید (مانند «"Name = tls_ssid"»).

[global]
Name = Example
Description = Example network configuration
[service_tls]
Type = wifi
SSID = 746c735f73736964
EAP = tls
CACertFile = /home/user/.certs/ca.pem
ClientCertFile = /home/user/devlp/.certs/client.pem
PrivateKeyFile = /home/user/.certs/client.fsid.pem
PrivateKeyPassphraseType = fsid
Identity = user
[service_ttls]
Type = wifi
Name = ttls_ssid
EAP = ttls
CACertFile = /home/user/.cert/ca.pem
Phase2 = MSCHAPV2
Identity = user
[service_peap]
Type = wifi
Name = peap_ssid
EAP = peap
CACertFile = /home/user/.cert/ca.pem
Phase2 = MSCHAPV2
Identity = user
[service_home_ethernet]
Type = ethernet
IPv4 = 192.168.1.42/255.255.255.0/192.168.1.1
IPv6 = 2001:db8::42/64/2001:db8::1
MAC = 01:02:03:04:05:06
Nameservers = 10.2.3.4,192.168.1.99
SearchDomains = my.home,isp.net
Timeservers = 10.172.2.1,ntp.my.isp.net
Domain = my.home
[service_home_wifi]
Type = wifi
Name = my_home_wifi
Passphrase = password
IPv4 = 192.168.2.2/255.255.255.0/192.168.2.1
MAC = 06:05:04:03:02:01
[service_vlan]
Type = ethernet
DeviceName = enp4s0.1
IPv4 = 192.168.1.42/255.255.255.0/192.168.1.1

connman(8)

2015-10-15