מדריך זה מסביר כיצד לחבר את Autopilot ב-Atera לסביבת Salesforce שלך באמצעות אפליקציית Salesforce Connected App שלך.
התהליך כולל:
שליפת אסימון ההרשאה שלך מ-Atera
הגדרת ה-Client ID וה-Client Secret שלך ב-Salesforce
יצירת קישור הרשאה ל-Salesforce
אישור הגישה בתוך Salesforce
לפני שמתחילים
ודאו שיש לכם:
Client ID של Salesforce שלכם
Client Secret של Salesforce שלכם
גישה ל-Atera (מומלץ הרשאות מנהל)
משתמש Salesforce עם הרשאות מתקדמות (מנהל מערכת או משתמש אינטגרציה)
שליפת אסימון ההרשאה שלך מ-Atera
כדי לבצע את ההגדרה, תצטרכו אסימון Bearer תקף של Auth0 מהסשן הפעיל שלכם ב-Atera.
איך לשלוף אותו
פתחו את Atera בדפדפן שלכם.
פתחו את כלי המפתחים (לחצו F12).
עברו ללשונית Network.
רעננו את הדף (או בצעו פעולה שמפעילה קריאת API).
לחצו על כל בקשה שנשלחת אל: https://app.atera.com/...
מתחת ל-Request Headers, מצאו את Authorization: Bearer <token>
העתיקו את ערך האסימון המלא (כל מה שמופיע אחרי
Bearer).
תשתמשו באסימון הזה כ-Bearer Token ב-Postman או ב-cURL.
הערה: אם אינכם מעוניינים לשתף את האסימון, תוכלו לבצע את קריאות ה-API בעצמכם תוך כדי שיתוף מסך עם התמיכה ולהדביק את האסימון ישירות ב-Postman אצלכם.
הגדרת פרטי Salesforce שלך ב-Atera
שלב זה שומר בצורה מאובטחת את פרטי ה-Connected App של Salesforce בתוך Atera.
Endpoint
POST https://app.atera.com/proxy/integrationssalesforce/management/configure
אימות
Bearer Token (אסימון Auth0 ששלפתם קודם)
כותרות
Authorization: Bearer <AUTH0_TOKEN>
Content-Type: application/json
גוף הבקשה (JSON)
{
"ClientId": "YOUR_SALESFORCE_CLIENT_ID",
"ClientSecret": "YOUR_SALESFORCE_CLIENT_SECRET"
}
הגדרה ב-Postman
שיטה: POST
כתובת URL:
https://app.atera.com/proxy/integrationssalesforce/management/configureלשונית Authorization:
Type = Bearer Token
Token =<AUTH0_TOKEN>
דוגמה ל-cURL
curl --request POST \
--url "https://app.atera.com/proxy/integrationssalesforce/management/configure" \
--header "Authorization: Bearer <AUTH0_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
"ClientId": "<SALESFORCE_CLIENT_ID>",
"ClientSecret": "<SALESFORCE_CLIENT_SECRET>"
}'
תוצאה צפויה
קוד HTTP 200 או 204
זה אומר ש-Atera שמרה בהצלחה את פרטי Salesforce שלך.
יצירת קישור הרשאה ל-Salesforce
כעת, צרו את קישור ההרשאה הנדרש להשלמת החיבור.
Endpoint
GET https://app.atera.com/proxy/integrationssalesforce/management/authorize
כותרת
Authorization: Bearer <AUTH0_TOKEN>
הגדרה ב-Postman
שיטה: GET
כתובת URL:
https://app.atera.com/proxy/integrationssalesforce/management/authorizeלשונית Authorization:
Bearer Token =<AUTH0_TOKEN>
דוגמה ל-cURL
curl --request GET \
--url "https://app.atera.com/proxy/integrationssalesforce/management/authorize" \
--header "Authorization: Bearer <AUTH0_TOKEN>"
תוצאה צפויה
גוף התגובה יכיל מחרוזת URL דומה ל:
https://login.salesforce.com/services/oauth2/authorize?...
העתיקו את ה-URL הזה.
אשרו גישה ב-Salesforce
פתחו את קישור ההרשאה בדפדפן שלכם.
התחברו עם משתמש Salesforce עם הרשאות מתקדמות (מנהל מערכת או משתמש אינטגרציה).
עברו על ההרשאות המבוקשות ואשרו אותן.
לאחר האישור, Salesforce תבצע הפניה אוטומטית ותשלים את חיבור ה-OAuth.
אישור ההטמעה
ההטמעה הצליחה כאשר:
הבקשה
POST /configureהחזירה 200 או 204הבקשה
GET /authorizeהחזירה כתובת Salesforce תקינהפתחתם את הקישור ואישרתם גישה
(אם זה מוצג אצלכם) סטטוס ההטמעה מציג מחובר
פתרון תקלות
שגיאת 401 או 403 מ-Endpoints של Atera
סיבה:
אסימון Auth0 חסר, פג תוקף או שייך לדייר (tenant) לא נכון.
פתרון:
העתיקו שוב את האסימון מ-DevTools בסשן הפעיל שלכם ב-Atera.
ודאו שהכותרת היא בדיוק:
Authorization: Bearer <token>
לא נוצר קישור הרשאה
סיבה:
ייתכן שהפרטים לא נשמרו בהצלחה.
פתרון:
הריצו שוב את הבקשה
POST /configure.ודאו שהיא מחזירה HTTP 200 או 204.
בדקו ש-Client ID ו-Client Secret תואמים לאפליקציית Salesforce Connected App שלכם.
האישור ב-Salesforce נכשל או מוצגת שגיאה
סיבות נפוצות:
האפליקציה המחוברת לא מוגדרת נכון (callback URL, הרשאות OAuth או הגדרות OAuth)
למשתמש Salesforce אין הרשאות מתאימות
פתרון:
בדקו את הגדרות ה-OAuth של האפליקציה המחוברת שלכם.
ודאו שכתובת ה-callback הנכונה מוגדרת.
ודאו שההרשאות (scopes) הנדרשות ב-OAuth מסומנות.
השתמשו במשתמש Salesforce עם הרשאות מתקדמות במידת הצורך.
