
एक सरल सर्वर जो CA/Browser Forum Baseline Requirements के धारा 2.2 द्वारा आवश्यक वैध, रद्द और समाप्त प्रमाणपत्रों को होस्ट करता है।
यह CA/Browser फ़ोरम की बेसलाइन आवश्यकताओं (Baseline Requirements) द्वारा अपेक्षित टेस्ट पेजों को होस्ट करने के लिए विशेष रूप से बनाया गया एक वेबसर्वर है। उनमें निम्नलिखित आवश्यकता शामिल है:
CA को ऐसे टेस्ट वेब पेज होस्ट करने चाहिए जो एप्लिकेशन सॉफ़्टवेयर आपूर्तिकर्ताओं को उनके सॉफ़्टवेयर का परीक्षण सब्सक्राइबर प्रमाणपत्रों (Subscriber Certificates) के साथ करने की अनुमति दें, जो प्रत्येक सार्वजनिक रूप से विश्वसनीय रूट प्रमाणपत्र (Root Certificate) तक श्रृंखलाबद्ध हों। न्यूनतम रूप में, CA को सब्सक्राइबर प्रमाणपत्रों का उपयोग करते हुए अलग-अलग वेब पेज होस्ट करने चाहिए जो वैध, निरस्त (revoked), और समाप्त (expired) हों।
यह प्रमाणपत्र प्राप्त करने के लिए ACME प्रोटोकॉल का उपयोग करता है। यह एक सरल वेबसाइट प्रस्तुत करता है जिसमें कुछ जानकारी होती है जो बताती है कि टेस्ट साइट किस उद्देश्य के लिए है।
हालाँकि यह Let's Encrypt के लिए बनाया गया था, यह अन्य ACME CA द्वारा भी उपयोग किया जा सकता है।
अधिक जानकारी के लिए, Let's Encrypt ब्लॉग पोस्ट देखें।
यह एक स्टैंडअलोन Go प्रोग्राम है।
go run main.go -config [path/to/config.json]
कॉन्फ़िगरेशन स्कीमा के लिए config/config.go देखें और वैध कॉन्फ़िगरेशन के उदाहरण के लिए config/testdata/test.json देखें। इंटीग्रेशन टेस्ट कॉन्फ़िगरेशन रनटाइम पर integration/configgen द्वारा उत्पन्न किया जाता है।
हम स्थानीय परीक्षण के लिए एक docker-compose.yml फ़ाइल प्रदान करते हैं। यह स्वचालित रूप से Pebble, एक टेस्ट CA, को तैनात करेगा। निष्पादित करें:
docker compose up --build
फिर, किसी एक टेस्ट साइट तक पहुँचें।
वे यहाँ उपलब्ध हैं:
ये URL तुरंत काम कर सकते हैं, लेकिन यदि वे आपके सिस्टम पर रिज़ॉल्व नहीं होते हैं, तो आप curl से उन्हें रिज़ॉल्व करवा सकते हैं:
curl -k --resolve revoked.localhost:5001:127.0.0.1 'https://revoked.localhost:5001/'
यदि आप ब्राउज़र से साइटों तक पहुँचना चाहते हैं, तो अपनी /etc/hosts फ़ाइल को संपादित करके उसमें टेस्ट सर्ट्स के पते शामिल करें।
127.0.0.1 valid.localhost revoked.localhost expired.localhost
यह सॉफ़्टवेयर अन्य CA से देखी गई कई घटनाओं से प्रेरित था, साथ ही ऑफ़-द-शेल्फ़ टूल का उपयोग करते हुए हमारे मौजूदा समाधान की जटिलता से भी।
हमने जिन घटनाओं की श्रेणियाँ देखी हैं उनमें शामिल हैं:
ACME इंटीग्रेशन वाला सर्वर यह सुनिश्चित करने का सबसे विश्वसनीय तरीका है कि प्रमाणपत्र अद्यतित रखे जाएँ, लेकिन निरस्त और समाप्त प्रमाणपत्रों को प्रस्तुत करने की असामान्य आवश्यकताएँ अन्य सिस्टमों की एक विशिष्ट विशेषता नहीं हैं। मॉनिटरिंग सिस्टम भी आमतौर पर यह सुनिश्चित करने का समर्थन नहीं करते कि प्रमाणपत्र निरस्त या समाप्त हैं।
वर्तमान में, test-certs-site केवल TLS-ALPN-01 सत्यापन विधि का समर्थन करता है। इस चुनौती को पूरा करने के लिए, और टेस्ट साइटों को प्रस्तुत करने के लिए, यह प्रोग्राम एक कॉन्फ़िगर करने योग्य पोर्ट पर सुनता है, जिसे TLS पोर्ट, :443 के रूप में उजागर किया जाना चाहिए।
ध्यान दें कि टेस्ट कॉन्फ़िगरेशन में यह डिफ़ॉल्ट रूप से :5001 पर सुनता है, जो Pebble के डिफ़ॉल्ट सत्यापन पोर्ट से मेल खाता है।
वर्तमान में, test-certs-site सभी कुंजी सामग्री को डिस्क पर पथों के रूप में संग्रहीत करता है। क्लाउड या अल्पकालिक (ephemeral) वातावरणों में cert-test-program चलाना आसान बनाने के लिए, हम कुंजियों को सीक्रेट्स प्रबंधन में स्थायी रूप से संग्रहीत करने के लिए किसी तंत्र का समर्थन करना चाहेंगे।
कुंजी और प्रमाणपत्र संग्रहण के अलावा, यह प्रोग्राम स्टेटलेस है।
एक कॉन्फ़िगर करने योग्य डीबग लिसनर है जो /debug/pprof और /metrics को उजागर करता है। लॉग JSON में stderr पर प्रिंट होते हैं।