C में छोटा, पोर्टेबल एम्बेड करने योग्य SSHv2 क्लाइंट और सर्वर लाइब्रेरी, जिसमें एम्बेडेड और IoT सिस्टम के लिए SCP, SFTP, पोर्ट फ़ॉरवर्डिंग, और पोस्ट-क्वांटम की एक्सचेंज शामिल है।
wolfSSL का एम्बेडेबल SSH सर्वर wolfSSH मैनुअल
wolfSSH wolfCrypt पर निर्भर है, जो wolfSSL का एक हिस्सा है। wolfSSH को सक्षम करने के लिए wolfSSL का सबसे सरल कॉन्फ़िगरेशन निम्नलिखित है।
$ cd wolfssl
$ ./configure [OPTIONS] --enable-ssh
$ make check
$ sudo make install
कुछ सिस्टम पर इंस्टॉल करने के बाद वैकल्पिक ldconfig कमांड की आवश्यकता होती है।
wolfSSH में key generation फ़ंक्शन का उपयोग करने के लिए, wolfSSL को keygen के साथ कॉन्फ़िगर करना होगा: --enable-keygen।
उपयोगकर्ता प्रमाणीकरण के लिए X.509 प्रमाणपत्रों का उपयोग करते समय, wolfSSL को TLS सक्षम के साथ बनाया जाना चाहिए। wolfSSH X.509 के लिए wolfSSL की certificate manager प्रणाली का उपयोग करता है, जिसमें OCSP लुकअप भी शामिल है। OCSP की अनुमति देने के लिए, wolfSSL configure में --enable-ocsp जोड़ें।
यदि wolfSSL कोड का अधिकांश भाग वांछित नहीं है, तो wolfSSL को केवल क्रिप्टो विकल्प के साथ कॉन्फ़िगर किया जा सकता है: --enable-cryptonly।
wolfSSL के लिए अतिरिक्त बिल्ड विकल्प wolfSSH मैनुअल के अध्याय दो में दिए गए हैं।
wolfSSH स्रोत निर्देशिका से चलाएँ:
$ ./autogen.sh (यदि GitHub से क्लोन किया गया है)
$ ./configure --with-wolfssl=[/usr/local]
$ make
$ make check
autogen.sh स्क्रिप्ट को रिपॉज़िटरी क्लोन करने के बाद केवल पहली बार चलाना होता है। यदि आप इसे पहले ही चला चुके हैं या स्रोत संग्रह से कोड का उपयोग कर रहे हैं, तो आपको इसे छोड़ देना चाहिए।
Visual Studio के साथ Windows पर बिल्ड करने के लिए, "ide/winvs/README.md" फ़ाइल देखें।
नोट: संसाधन-सीमित उपकरणों पर DEFAULT_WINDOW_SZ को कम आकार पर सेट करने की आवश्यकता हो सकती है। बड़े फ़ाइल स्थानांतरण में सहायता के लिए डेस्कटॉप उपयोग के मामलों में इसे बढ़ाया भी जा सकता है। डिफ़ॉल्ट रूप से चैनलों को channel window adjust संदेश भेजने से पहले 128kB तक डेटा प्राप्त करने के लिए सेट किया जाता है। नए चैनलों के लिए विंडो आकार सेट करने का एक उदाहरण इस प्रकार होगा ./configure CPPFLAGS="-DDEFAULT_WINDOW_SZ=16384"
32bit Linux प्लेटफ़ॉर्म के लिए आप CFLAGS=-D_FILE_OFFSET_BITS=64 के साथ कंपाइल करके 2GB से बड़ी फ़ाइलों के लिए समर्थन जोड़ सकते हैं।
examples निर्देशिका में एक echoserver है जिससे कोई भी क्लाइंट कनेक्ट कर सकता है। टर्मिनल से चलाएँ:
$ ./examples/echoserver/echoserver -f
विकल्प -f echo-only मोड सक्षम करता है। दूसरे टर्मिनल से चलाएँ:
$ ssh jill@localhost -p 22222
पासवर्ड के लिए संकेत मिलने पर, "upthehill" दर्ज करें। सर्वर क्लाइंट को एक पूर्वनिर्धारित बैनर भेजेगा:
wolfSSH Example Echo Server
क्लाइंट में टाइप किए गए अक्षर सर्वर द्वारा स्क्रीन पर प्रतिध्वनित किए जाएंगे। यदि अक्षर दो बार प्रतिध्वनित होते हैं, तो क्लाइंट में local echo सक्षम है। echoserver उचित टर्मिनल नहीं है इसलिए CR/LF अनुवाद अपेक्षित रूप से काम नहीं करेगा।
निम्नलिखित नियंत्रण वर्ण echoserver में विशेष क्रियाएँ ट्रिगर करेंगे:
रिपॉज़िटरी क्लोन करने के बाद, सुनिश्चित करें कि परीक्षण निजी कुंजियाँ उपयोगकर्ता के लिए read-only हों, अन्यथा ssh आपको ऐसा करने के लिए कहेगा।
$ chmod 0600 ./keys/gretel-key-rsa.pem ./keys/hansel-key-rsa.pem \
./keys/gretel-key-ecc.pem ./keys/hansel-key-ecc.pem
उदाहरण echoserver के विरुद्ध प्रमाणीकरण पासवर्ड या सार्वजनिक कुंजी से किया जा सकता है। पासवर्ड का उपयोग करने के लिए कमांड लाइन:
$ ssh -p 22222 USER@localhost
जहाँ USER और पासवर्ड के जोड़े हैं:
jill:upthehill
jack:fetchapail
सार्वजनिक कुंजी प्रमाणीकरण का उपयोग करने के लिए कमांड लाइन का उपयोग करें:
$ ssh -i ./keys/USER-key-TYPE.pem -p 22222 USER@localhost
जहाँ USER gretel या hansel हो सकता है, और TYPE rsa या ecc है।
ध्यान रखें, echoserver में इसके wsUserAuth() कॉलबैक फ़ंक्शन में कई नकली खाते हैं। (jack, jill, hansel, और gretel) जब shell समर्थन सक्षम होता है, तो वे नकली खाते काम नहीं करेंगे। वे सिस्टम की passwd फ़ाइल में मौजूद नहीं हैं। उपयोगकर्ता प्रमाणित होंगे, लेकिन सर्वर त्रुटि देगा क्योंकि वे सिस्टम में मौजूद नहीं हैं। आप echoserver में पासवर्ड या सार्वजनिक कुंजी सूची में अपना स्वयं का उपयोगकर्ता नाम जोड़ सकते हैं। वह खाता echoserver द्वारा शुरू किए गए shell में लॉग इन होगा, जिसमें echoserver चलाने वाले उपयोगकर्ता के विशेषाधिकार होंगे।
wolfSSH परीक्षण उद्देश्यों के लिए और अन्य SSH कार्यान्वयनों के साथ अंतर-संचालनशीलता प्रदर्शित करने के लिए कुछ उदाहरण उपकरणों के साथ पैकेज किया गया है।
echoserver wolfSSH का मुख्य कार्यकर्ता है। यह मूल रूप से केवल किसी एक पूर्वनिर्धारित खाते को प्रमाणित करने की अनुमति देता था और उसमें टाइप किए गए अक्षरों को दोहराता था। shell समर्थन सक्षम करने पर, यह उपयोगकर्ता shell उत्पन्न कर सकता है। इसके लिए मशीन पर एक वास्तविक उपयोगकर्ता नाम और क्रेडेंशियल्स को मान्य करने के लिए एक अद्यतन उपयोगकर्ता प्रमाणीकरण कॉलबैक फ़ंक्शन की आवश्यकता होगी। echoserver SCP और SFTP कनेक्शन भी संभाल सकता है।
echoserver उपकरण निम्नलिखित कमांड लाइन विकल्प स्वीकार करता है:
-1 exit after a single (one) connection
-e expect ECC public key from client
-E use ECC private key
-f echo input
-p <num> port to accept on, default 22222
-N use non-blocking sockets
-d <string> set the home directory for SFTP connections
-j <file> load in a public key to accept from peer
client एक SSH सर्वर से कनेक्शन स्थापित करता है। अपने सरलतम मोड में, यह सर्वर को "Hello, wolfSSH!" स्ट्रिंग भेजता है, प्रतिक्रिया प्रिंट करता है, और फिर बाहर निकल जाता है। pseudo terminal विकल्प के साथ, client एक वास्तविक client होगा।
client उपकरण निम्नलिखित कमांड लाइन विकल्प स्वीकार करता है:
-h <host> host to connect to, default 127.0.0.1
-p <num> port to connect on, default 22222
-u <username> username to authenticate as (REQUIRED)
-P <password> password for username, prompted if omitted
-e use sample ecc key for user
-i <filename> filename for the user's private key
-j <filename> filename for the user's public key
-x exit after successful connection without doing
read/write
-N use non-blocking sockets
-t use pseudo terminal
-c <command> executes remote command and pipe stdin/stdout
-a Attempt to use SSH-AGENT
portfwd उपकरण एक SSH सर्वर से कनेक्शन स्थापित करता है और स्थानीय पोर्ट फ़ॉरवर्डिंग के लिए एक श्रोता सेट करता है या दूरस्थ पोर्ट फ़ॉरवर्डिंग के लिए एक श्रोता का अनुरोध करता है। कनेक्शन के बाद, उपकरण समाप्त हो जाता है।
portfwd उपकरण निम्नलिखित कमांड लाइन विकल्प स्वीकार करता है:
-h <host> host to connect to, default 127.0.0.1
-p <num> port to connect on, default 22222
-u <username> username to authenticate as (REQUIRED)
-P <password> password for username, prompted if omitted
-F <host> host to forward from, default 0.0.0.0
-f <num> host port to forward from (REQUIRED)
-T <host> host to forward to, default to host
-t <num> port to forward to (REQUIRED)
scpclient, wolfscp, एक SSH सर्वर से कनेक्शन स्थापित करता है और निर्दिष्ट फ़ाइलों को स्थानीय मशीन से या उस पर कॉपी करता है।
scpclient उपकरण निम्नलिखित कमांड लाइन विकल्प स्वीकार करता है:
-H <host> host to connect to, default 127.0.0.1
-p <num> port to connect on, default 22222
-u <username> username to authenticate as (REQUIRED)
-P <password> password for username, prompted if omitted
-L <from>:<to> copy from local to server
-S <from>:<to> copy from server to local
sftpclient, wolfsftp, एक SSH सर्वर से कनेक्शन स्थापित करता है और निर्देशिका नेविगेशन, फ़ाइलें प्राप्त करना और रखना, निर्देशिकाएँ बनाना और हटाना, आदि की अनुमति देता है।