מפתחות וסודות

לפני השימוש מפתחות, חבר את הפרויקט אל Atoms Cloud. אם הוא לא מחובר, בקש מה-Agent לחבר את Atoms Cloud או פעל לפי Atoms Cloud.

השתמש במפתח ב-Atoms Cloud

לפני שמתחילים

לפני הוספת מפתח, ודא ש:

• אתה משתמש ב-Atoms בגרסת הווב למחשב שולחני.
• הפרויקט מחובר אל Atoms Cloud.
• אתה בעלים של סביבת העבודה. רק בעלי סביבת עבודה יכולים להוסיף מפתחות חדשים.

אם מפתחות או מפתח חדש אינו זמין, ודא שפתחת את הפרויקט המתאים ושהוא מחובר אל Atoms Cloud. אם מפתח חדש עדיין אינו זמין, ודא שאתה בעלים של סביבת העבודה. אם Atoms מציג הודעת זמינות של תוכנית או שימוש, פעל לפי נתיב הזמינות או השדרוג שעל המסך, ואז נסה שוב.

הוסף מפתח Test

1. פתח את הפרויקט במכשיר שולחני.
2. באותו סרגל כלים של סביבת העבודה שבו נמצא App Viewer בחר Atoms Cloud.
3. בחר מפתחות בסרגל הצד של Atoms Cloud.
4. פתח Test Keys, ואז בחר In This Project.
5. בחר מפתח חדש.
6. השלם את השדות הנדרשים:
   • שם: הזן שם ייחוס ברור, כגון RESEND_API_KEY. השתמש באותיות, מספרים וקווים תחתונים, והתחל באות או בקו תחתון.
   • ערך: הזן את פרטי הגישה בדיוק כפי שסופקו על ידי הספק.
   • תיאור: הסבר למה המפתח משמש, כגון משמש לשליחת אימיילים של חשבון. אל תכלול את ערך פרטי הגישה.
7. אם ברצונך לעשות שימוש חוזר במפתח בפרויקטים אחרים, בחר Save to Library.
8. בחר הוסף. כאשר המפתח נשמר, Atoms מציג המפתח נוסף בהצלחה.

הוסף מפתח Test

רק בעלי סביבת עבודה יכולים להוסיף מפתחות חדשים. אם אתה צריך שיוסיפו מפתח, פנה לבעלים של סביבת העבודה.

השתמש במפתח שמור ב-Chat

הפנה למפתח השמור במקום להזין את הערך שלו בהודעה.

1. פתח את הפרויקט Chat בגרסת המחשב של Atoms והקלד #.
2. בחר מפתחות.
3. חפש את המפתח השמור, ואז בחר את שמו.
4. הסבר ל-Agent למה המפתח משמש ומה אתה רוצה שהאינטגרציה תעשה.

ה # תפריט מוסיף הפניה למפתח השמור בלי להכניס את הערך שלו להודעה שלך.

הפנה למפתח שמור ב-Chat

בדוק מפתח שמור

1. ב App Viewer, בצע פעולה פשוטה שמשתמשת במפתח.
2. ודא שהיא מפיקה את התוצאה הצפויה, כגון שליחת אימייל בדיקה או החזרת נתוני בדיקה.
3. בדוק שגיאות או יומנים גלויים וודא שהם לא חושפים את ערך המפתח.

אם השירות מספק לך מפתחות test ו-live נפרדים, השתמש במפתח ה-test בזמן בניית האפליקציה שלך. השתמש במפתח ה-live רק לאחר שהאפליקציה שלך פורסמה. אם הבדיקה נכשלת, בדוק את לוח הבקרה של הספק כדי לוודא שהמפתח פעיל ושיש לו הרשאה לבצע את הפעולה המבוקשת. לעולם אל תדביק את ערך המפתח ב-Chat בעת פתרון תקלות.

הבן כיצד Keys פועלים

לפני הוספת מפתחות, כדאי להבין מה Atoms שומר וכיצד להגן על פרטי הגישה שלך.

מה Atoms שומר

Atoms Cloud → Keys שומר פרטי גישה שהאפליקציה שלך משתמשת בהם כדי להתחבר לשירותים חיצוניים, כגון מפתחות API ואסימוני גישה.

לכל מפתח שמור יש שם, תיאור וערך פרטי. השם והתיאור עוזרים ל-Agent להבין מתי להשתמש במפתח, בעוד שהערך הפרטי נשאר מוסתר מ- Chat.

היכן להשיג מפתח

Atoms אינו יוצר או מספק פרטי גישה לשירותים חיצוניים. עליך להשיג אותם מספק השירות הרלוונטי. פעל לפי הוראות הספק בעת בחירת הרשאות, בדיקת המפתח ובדיקה אם תוקפו פג.

שמור על סודיות פרטי גישה פרטיים

לעולם אל תדביק פרטי גישה פרטיים ב- Chat, קוד מקור, קוד שרץ בדפדפן, צילומי מסך, יומנים או הודעות תמיכה. שמור אותם ב- מפתחות, ואז הפנה לערך השמור לפי שמו.

אם ערך פרטי כבר נחשף, התייחס אליו כאל ערך שנפגע ובטל או החלף אותו דרך הספק.

פרטי גישה פרטיים ובטוחים לדפדפן

מפתחות אינו מתייג ערכים שמורים כ- Public או Private. שמירת ערך ב- מפתחות אינה הופכת אותו אוטומטית לבטוח לשימוש בקוד שפונה לדפדפן. אם האפליקציה שלך משתמשת בערך בדפדפן, ייתכן שמבקרים יוכלו לבדוק אותו.

בדוק את התיעוד של הספק לפני שתחליט היכן להשתמש בפרטי גישה:

• השתמש בערך בקוד שפונה לדפדפן רק כאשר הספק מציין במפורש שבטוח לחשוף אותו.
• שמור פרטי גישה פרטיים בלוגיקה בצד השרת או ב-backend, שם הם אינם חשופים למבקרי האפליקציה.

בחר את הסביבה והאחסון של המפתח

בעת הוספת מפתח, עליך לקבל שתי החלטות נפרדות:

• איזו סביבה תשתמש במפתח.
• האם המפתח יישאר בפרויקט הזה או יהיה זמין לפרויקטים אחרים.

בחר סביבה

אפשרות	מתי הוא בשימוש
Test Keys	בשימוש בזמן פיתוח ובדיקת האפליקציה שלך ב- App Viewer. אם לא תוסיף ערך Production נפרד, האפליקציה שפורסמה תשתמש גם היא בערך ה-Test.
Production Keys	בשימוש על ידי האפליקציה שפורסמה כאשר נדרש פרטי גישה live נפרדים. ערכי Production מתווספים במהלך תהליך הפרסום ומנוהלים בנפרד מערכי Test.

בחר היכן לשמור את המפתח

אפשרות	מתי להשתמש בו
In This Project	בחר באפשרות זו עבור מפתח שאמור לשמש רק את הפרויקט הנוכחי.
Key Library	בחר באפשרות זו כאשר אתה רוצה בכוונה לעשות שימוש חוזר במפתח בכמה פרויקטים. בעת הוספה או עדכון של מפתח Test, בחר Save to Library כדי להפוך אותו לזמין בספרייה.

הסביבה ומיקום האחסון הם בלתי תלויים. שמירת מפתח Test ב- Key Library הופכת אותו לניתן לשימוש חוזר, אך אינה הופכת אותו לערך Production.

השתמש ב- In This Project כברירת מחדל. שמור מפתח בספרייה רק כאשר אתה בטוח שהוא צריך להיות משותף בין פרויקטים.

השתמש בערך Production נפרד

כאשר אתה מפרסם פרויקט שמשתמש במפתח שמור, ייתכן שתהליך הפרסום יבקש ממך להגדיר Production Keys. כברירת מחדל, האפליקציה שפורסמה משתמשת בערך ה-Test. כדי להשתמש בפרטי גישה שונים, בחר Production ושמור ערך נפרד עבור המפתח.

השתמש בערך Production נפרד כאשר:

• הספק מספק פרטי גישה שונים ל-test ול-live.
• אינך רוצה שפרטי הגישה ששימשו במהלך הפיתוח ישמשו את האפליקציה שפורסמה.

ערכי Production נוצרים דרך תהליך הפרסום. אינך יכול ליצור אחד על ידי בחירה ב- מפתח חדש מתוך הכרטיסייה Production Keys לאחר שהוגדר ערך Production עבור אפליקציה שפורסמה, תוכל לראות אותו תחת Atoms Cloud → Keys → Production Keys.

לאחר פרסום או עדכון האפליקציה, חזור על מסע המשתמש הרלוונטי באתר שפורסם כדי לוודא שמפתח ה-Production פועל כראוי. לתהליך הפריסה המלא, ראה פרסום ופריסה.

עדכן או החלף פרטי גישה

עדכן ערך Test שמור

1. פתח Atoms Cloud → Keys → Test Keys.
2. פתח In This Project או Key Library, בהתאם למקום שבו הערך נשמר.
3. בחר את ערך או תיאור, של המפתח, הזן את המידע המעודכן, ואז בחר עדכן.
4. המתן ל- השמירה הצליחה, ואז בדוק שוב את הזרימה המושפעת.

החלפת מפתח מתוכננת

פעל לפי השלבים האלה כאשר פרטי הגישה הקיימים עדיין מאובטחים ואתה רוצה להחליף אותם בלי להפריע לאפליקציה שלך:

1. צור פרטי גישה חלופיים דרך ספק השירות.
2. החלף את ערך ה-Test ב-Atoms, ואז בדוק את התכונה המושפעת ב- App Viewer.
3. אם האפליקציה שפורסמה משתמשת בערך Production נפרד, החלף אותו ופרסם את העדכון.
4. בדוק את אותה תכונה באתר שפורסם.
5. לאחר שאישרת שההחלפה פועלת כראוי, בטל את פרטי הגישה הישנים דרך הספק.

אם ייתכן שפרטי גישה נחשפו

התייחס לפרטי הגישה כאל כאלה שנפגעו ופעל מיד:

1. בטל או השבת אותם דרך ספק השירות.
2. צור פרטי גישה חלופיים.
3. עדכן את ערכי ה-Test וה-Production הרלוונטיים ב-Atoms.
4. בדוק שוב את התכונות המושפעות גם ב- App Viewer וגם באפליקציה שפורסמה.
5. הסר כל עותק חשוף מקוד המקור, Chat, צילומי מסך ויומנים, היכן שאפשר.

מחיקת מפתח או הסרת הערך שלו מ-Atoms אינה מבטלת את פרטי הגישה המקוריים. עליך לבטל אותם דרך ספק השירות.

הסר פרטי גישה

לפני מחיקת מפתח שמור, ודא שהאפליקציה שלך כבר אינה תלויה בו:

1. הסר את התכונה שמשתמשת במפתח, או החלף את ההפניות שלה במפתח שמור אחר.
2. בטל את פרטי הגישה המקוריים דרך ספק השירות כך שלא ניתן יהיה עוד להשתמש בהם.
3. פתח Atoms Cloud → Keys, מצא את הערך הלא פעיל, בחר מחק, ואשר.

לא ניתן לבטל מחיקת מפתח. היא גם עלולה לשבור תצוגות מקדימות או נקודות ביקורת ישנות יותר שעדיין מפנות אליו. אם מחק אינו זמין, המפתח עדיין מסומן כפעיל. הסר או החלף כל הפניה אליו לפני שתנסה שוב.

שאלות נפוצות

מפתח ה-Test שלי עובד ב-App Viewer אבל לא אחרי הפרסום. למה?

אם מפתח ה-Test שלך עובד ב-App Viewer אבל האפליקציה שפורסמה נכשלת כי מפתח חסר או ריק:

1. בדוק אם ערך ה-Test או ה-Production הרלוונטי נשמר לפני או אחרי הפרסום האחרון. אם הוא נשמר לאחר מכן, פרסם שוב כדי שהשינוי ייכנס לתוקף.
2. ודא שלמפתח השמור יש את ערך ה-Test או ה-Production הנכון. האפליקציה שפורסמה משתמשת בערך ה-Test אלא אם הוגדר ערך Production נפרד.
3. בדוק שגיאות משירותי המשך לקבלת רמזים. “Unauthorized” מצביע בדרך כלל על מפתח ריק או שגוי עבור אותה סביבה.

אם הבעיה נמשכת, פנה לתמיכה וכלול:

• קישור לפרויקט או URL חי
• שם המפתח המושפע והאם הבעיה היא בערך ה-Test או ה-Production
• השגיאה המלאה מהשירות במורד הזרם
• צילום מסך מנוקה של דף התצורה
• האם תצורת המפתח נשמרה לפני או אחרי הפרסום

חשוב: ספק רק שמות מפתחות. אל תשלח ערכים סודיים, סיסמאות או אסימונים.