Polyguard PreScreen: Greenhouse सेटअप¶

यह गाइड एक Greenhouse व्यवस्थापक को आपकी नौकरी के आवेदनों को Polyguard ट्रस्ट चेक से सुरक्षित करने के लिए आवश्यक हर चीज़ से गुज़ारती है। ऊपर से नीचे तक काम करें। हर अनुभाग एक या दो मान बनाता है जिन्हें आप आगे बढ़ते हुए Polyguard व्यवस्थापक कंसोल (/admin) में पेस्ट करते हैं। पूरा सेटअप लगभग 20 मिनट लेता है।

शुरू करने से पहले¶

आपको ऐसे Greenhouse उपयोगकर्ता की आवश्यकता है जिसके पास Dev Center टूल को प्रबंधित और कॉन्फ़िगर करने की अनुमति हो (आमतौर पर एक Site Admin)। Dev Center वह जगह है जहाँ API कुंजियाँ और web hook रहते हैं, और आप हर नौकरी की साक्षात्कार योजना भी संपादित करेंगे।

Polyguard /admin कंसोल (https://<आपका-polyguard-डोमेन>/admin) को दूसरे टैब में खुला रखें। आप पूरे समय इसमें मान पेस्ट करेंगे। वहाँ अपने स्वीकृत व्यवस्थापक ईमेल पर भेजे गए मैजिक लिंक से साइन इन करें।

रहस्य एक ही बार दर्ज किए जाते हैं। API कुंजियाँ और web hook रहस्य Greenhouse में केवल एक बार दिखाए जाते हैं, और /admin कंसोल उन्हें केवल-लेखन मोड में संग्रहीत करता है (बाद में केवल अंतिम 4 अक्षर दिखाता है)। हर मान को बनाते ही उसे /admin में कॉपी कर लें।

चरण 1: सत्यापित आवेदनों को सक्षम करें¶

यह चरण Polyguard करियर साइट को उम्मीदवार की ओर से सत्यापित आवेदन Greenhouse में जमा करने देता है।

1a. एक Job Board API कुंजी बनाएँ¶

Greenhouse में, ऊपरी नेविगेशन बार में Configure (⚙️) आइकन पर क्लिक करें।
बाएँ साइडबार में, Dev Center खोलें, फिर API Credential Management पर क्लिक करें।
Create new API credentials (ऊपर दाईं ओर) पर क्लिक करें।
संवाद बॉक्स में:
- API Type: Job Board चुनें।
- Partner: Unlisted vendor (या Custom) चुनें।
- Description: Polyguard: Job Board।
Manage permissions / Create पर क्लिक करें। Greenhouse स्वचालित रूप से Job Board अनुमतियाँ असाइन करता है।
कुंजी कॉपी करने के लिए Copy पर क्लिक करें, फिर उसे /admin में Job Board API key फ़ील्ड में पेस्ट करें। Greenhouse में, I have stored the API Key पर क्लिक करें।

⚠️ पूरी कुंजी एक ही बार दिखाई जाती है। पुष्टि करने से पहले इसे कॉपी कर लें; यदि आप इसे खो देते हैं तो आपको एक नई बनानी होगी।

यदि आप Job Board API कुंजी खाली छोड़ देते हैं, तो करियर साइट डेमो मोड में चलती है: यह Greenhouse में वास्तव में पोस्ट किए बिना दिखाती है कि वह क्या जमा करती। किसी कुंजी के लागू होने से पहले सूखे परीक्षण के लिए यह उपयोगी है।

1b. Polyguard सत्यापन टोकन के लिए एक कस्टम फ़ील्ड जोड़ें¶

जब कोई उम्मीदवार ट्रस्ट चेक पास करता है, तो Polyguard उनके आवेदन पर एक सत्यापन टोकन रिकॉर्ड करता है। इसे एक समर्पित कस्टम एप्लिकेशन फ़ील्ड में संग्रहीत करना इसे हर नौकरी में रिपोर्ट करने योग्य और सुसंगत रखता है। यह एक ही संगठन-व्यापी फ़ील्ड है, जो एक बार बनाई जाती है। Greenhouse का Create a new custom application field देखें:

Configure (⚙️) → Custom Options → Application (Custom Application Fields) पर जाएँ।
Add Field पर क्लिक करें। इसे Polyguard Verification Token नाम दें, फ़ील्ड प्रकार Single-line text। इसे सहेजें।
फ़ील्ड को फिर से खोलें और उसकी field key नोट करें, जिसे Greenhouse नाम से उत्पन्न करता है (उदाहरण के लिए, polyguard_verification_token)। इसे /admin में Polyguard field key बॉक्स में पेस्ट करें।

चरण 2: ट्रस्ट चेक चरण जोड़ें¶

हर आवेदन, चाहे वह Polyguard करियर साइट से आए या सीधे Greenhouse में, पहले इसी चरण में आता है। सत्यापित उम्मीदवार स्वचालित रूप से इससे आगे बढ़ जाते हैं; असत्यापित उम्मीदवार यहीं रोके जाते हैं जब तक कि वे ईमेल किए गए ट्रस्ट चेक को पास नहीं कर लेते। यह चरण उस चरण को बनाता है और Polyguard को बताता है कि चरण-परिवर्तनों का श्रेय किस उपयोगकर्ता को देना है।

2a. Polyguard ट्रस्ट चेक के लिए एक चरण जोड़ें¶

कोई नौकरी खोलें → Job Setup, फिर बाएँ पैनल में Interview Plan चुनें।
Add stage पर क्लिक करें, Create a custom stage चुनें, और इसे ठीक Human Verification नाम दें।
इसे पहला चरण बनाएँ, किसी भी मानव-समीक्षा चरण से पहले, ताकि हर आवेदन यहाँ आए। सत्यापित होने पर Polyguard हर उम्मीदवार को स्वचालित रूप से अगले चरण में आगे बढ़ा देता है।
उस ठीक चरण नाम को /admin में Gate stage name फ़ील्ड में दर्ज करें (मिलान बड़े-छोटे अक्षरों में अंतर नहीं करता, लेकिन इसे समान रूप से लिखें)।

यह चरण, समान नाम के साथ, उन हर नौकरी में पहले चरण के रूप में मौजूद होना चाहिए जिसे आप सुरक्षित करना चाहते हैं।

2b. अपनी मौजूदा खुली नौकरियों में चरण जोड़ें¶

चरण 2a एक ही नौकरी में चरण जोड़ता है, लेकिन यह उन हर नौकरी में पहला चरण होना चाहिए जिसे आप सुरक्षित करना चाहते हैं, उन रिक्तियों सहित जो पहले से सक्रिय हैं। हर नौकरी को हाथ से संपादित करने के बजाय, अपनी खुली नौकरियों में Human Verification चरण को लागू करने के लिए Greenhouse के थोक चरण संपादन का उपयोग करें। Edit job stage in bulk का पालन करें, और पुष्टि करें कि चरण हर नौकरी की साक्षात्कार योजना में पहले स्थान पर आता है।

2c. चरण-परिवर्तन क्रियाओं के लिए एक सिस्टम उपयोगकर्ता की आईडी रिकॉर्ड करें¶

Greenhouse हर चरण-परिवर्तन का श्रेय एक वास्तविक उपयोगकर्ता को देता है। Polyguard की ओर से कार्य करने के लिए एक उपयोगकर्ता चुनें (आदर्श रूप से एक समर्पित सेवा या भर्ती-संचालन खाता जिसके पास आवेदन ले जाने की अनुमति हो) और उनकी संख्यात्मक आईडी रिकॉर्ड करें।

Configure (⚙️) → Users पर जाएँ।
उस उपयोगकर्ता पर क्लिक करें जिसे आप चरण-परिवर्तनों का श्रेय देना चाहते हैं। यह उनका Edit User पृष्ठ खोलता है।
पृष्ठ के URL से संख्यात्मक आईडी पढ़ें। उदाहरण के लिए, https://app.greenhouse.io/account/user/12345 में, उपयोगकर्ता आईडी 12345 है।
उस आईडी को /admin में On-behalf-of user id फ़ील्ड में पेस्ट करें।

चरण 3: सबमिशन web hook कनेक्ट करें¶

Greenhouse तब एक web hook भेजता है जब कोई आवेदन जमा होता है। Polyguard कस्टम फ़ील्ड पर सत्यापन टोकन रिकॉर्ड करता है और आवेदन को गेट चरण से आगे बढ़ाता है: एक होस्टेड आवेदन आने पर ही आगे बढ़ जाता है; एक सीधा आवेदन तब आगे बढ़ता है जब उम्मीदवार ईमेल किए गए ट्रस्ट चेक को पास कर लेता है। इस चरण के लिए एक Harvest API कुंजी (चरण पढ़ने और आवेदन ले जाने के लिए) और स्वयं web hook की आवश्यकता होती है।

3a. एक Harvest (v1/v2) API कुंजी बनाएँ¶

Configure (⚙️) → Dev Center → API Credential Management पर लौटें और Create new API credentials पर क्लिक करें।
संवाद बॉक्स में:
- API Type: Harvest चुनें। यह कुंजी-आधारित v1/v2 क्रेडेंशियल (HTTP Basic प्रमाणीकरण) है जिसका उपयोग Polyguard करता है। एक Harvest V3 (OAuth) क्रेडेंशियल न बनाएँ; यह अभी समर्थित नहीं है।
- Partner: Unlisted vendor (या Custom) चुनें।
- Description: Polyguard: Harvest।
Manage permissions पर क्लिक करें। केवल उन एंडपॉइंट को सक्षम करें जिनका उपयोग Polyguard करता है (न्यूनतम विशेषाधिकार; बाकी सब कुछ अचयनित छोड़ दें):
- अनुमति Job Stages → Get: Retrieve Job Stages for Job
- अनुमति Applications → Patch / Move: Move Application
Save पर क्लिक करें, फिर कुंजी को Copy करें और उसे /admin में Harvest API key फ़ील्ड में पेस्ट करें।

⚠️ Job Board कुंजी की तरह, Harvest कुंजी भी एक ही बार दिखाई जाती है।

📷 अनुमति जाँच-सूची के लिए संदर्भ: https://support.greenhouse.io/hc/en-us/articles/115000521723-Manage-Harvest-API-credentials-permissions

3b. Harvest web hook सेट करें¶

Greenhouse हर बार Polyguard को कॉल करता है जब कोई उम्मीदवार आवेदन जमा करता है, ताकि सीधे आवेदनों को नियंत्रित किया जा सके।

सबसे पहले, अपना web hook URL प्राप्त करें। Polyguard /admin कंसोल खोलें; यह उपयोग करने के लिए सटीक एंडपॉइंट URL दिखाता है, जो पहले से ही आपके जॉब बोर्ड के लिए सीमित है, इस रूप में:

https://<आपका-polyguard-डोमेन>/api/greenhouse/webhook/<आपका-बोर्ड-टोकन>

उस URL को कॉपी करें, फिर Greenhouse में:

Configure (⚙️) → Dev Center → Web Hooks पर जाएँ।
Name this web hook: Polyguard: Candidate submitted application।
When: Candidate has submitted application चुनें।
Endpoint URL: /admin से URL पेस्ट करें (यह https होना चाहिए)।
Secret key: Polyguard /admin कंसोल में, एक रहस्य बनाने के लिए Harvest web hook secret के बगल में Generate पर क्लिक करें, उसे कॉपी करें, और यहाँ पेस्ट करें। मान दोनों जगह समान होना चाहिए।
Error Recipient Email: [email protected] दर्ज करें ताकि web hook डिलीवरी विफल होने लगे तो Polyguard को सूचित किया जाए।
Disabled? को No पर छोड़ दें और Create Web hook पर क्लिक करें।

📷 web hook फ़ॉर्म और हस्ताक्षर विवरण के लिए संदर्भ: https://support.greenhouse.io/hc/en-us/articles/360005574531-Create-a-webhook और https://developers.greenhouse.io/webhooks.html

चरण 4: `/admin` में सब कुछ सहेजें¶

अब तक आपको हर मान को बनाते समय /admin में पेस्ट कर देना चाहिए था। यह पुष्टि करने के लिए कि कुछ भी छूट न जाए एक अंतिम जाँच करें, फिर Save changes पर क्लिक करें।

`/admin` फ़ील्ड	कहाँ सेट किया गया	टिप्पणियाँ
Job Board API key	1a	सत्यापित आवेदन जमा करता है। सहेजने के बाद केवल-लेखन।
Polyguard field key	1b	कस्टम फ़ील्ड की कुंजी (उदाहरण, `polyguard_verification_token`); जहाँ हर आवेदन के लिए टोकन रिकॉर्ड होता है।
Gate stage name	2a	हर सुरक्षित नौकरी में पहले-चरण के नाम से मेल खाना चाहिए।
On-behalf-of user id	2c	Edit User URL से संख्यात्मक आईडी।
Harvest API key	3a	चरण पढ़ता है, आवेदन ले जाता है। सहेजने के बाद केवल-लेखन।
Harvest web hook secret	3b	Greenhouse में दर्ज किए गए रहस्य से मेल खाना चाहिए।

चरण 5: सत्यापित करें कि यह काम करता है¶

सूचियाँ: आपका Polyguard करियर होम पेज आपकी सक्रिय Greenhouse नौकरियाँ दिखाता है। (पुष्टि करता है कि आपका बोर्ड कनेक्ट है।)
सत्यापित सबमिशन: Polyguard करियर साइट के माध्यम से एक परीक्षण आवेदन जमा करें। Job Board कुंजी के साथ, पुष्टि करें कि यह Greenhouse में दिखता है, स्वचालित रूप से Human Verification से आगे बढ़ता है, और Polyguard Verification Token फ़ील्ड भर जाती है।
सीधा आवेदन: किसी सुरक्षित नौकरी में सीधे एक परीक्षण आवेदन बनाएँ और पुष्टि करें कि यह Human Verification में आता है, उम्मीदवार को एक ट्रस्ट चेक ईमेल मिलता है, और पास करने पर आवेदन आगे बढ़ जाता है।

यदि कोई web hook परीक्षण ट्रिगर नहीं होता, तो सबसे आम कारण गलत When इवेंट है। फिर से जाँचें कि यह "Candidate has submitted application" (चरण 3b) पर सेट है।