סודות ומשתני סביבה
ניהול מפתחות API ומשתני סביבה עבור ה-backend של Convex שלך.
לחץ על הכפתור Settings בסרגל הכלים של ה-builder כדי לפתוח את חלונית ההגדרות. היא מכילה שלושה חלקים:
| חלק | מיועד ל |
|---|---|
| General | שם הפרויקט ובסיס הידע |
| SEO & sharing | הגדרת כותרת האתר, התיאור ו-favicon |
| Secrets | משתני סביבה עבור ה-backend של Convex שלך |
כיצד מוסיפים סוד?
Section titled “כיצד מוסיפים סוד?”- לחץ על הכפתור Settings בסרגל הכלים של ה-builder
- פתח את הלשונית Secrets
- הזן שם (כמו
STRIPE_SECRET_KEY) וערך - לחץ על Add
כיצד משתמשים בסודות באפליקציה?
Section titled “כיצד משתמשים בסודות באפליקציה?”הסודות מסונכרנים ל-backend של Convex באפליקציה שלך. ניתן להתייחס אליהם בקוד action/mutation/query של Convex באמצעות process.env.SECRET_NAME. הם אינם זמינים בקוד ה-frontend שלך או כמשתני סביבה ברמת ה-pod — הדבר מונע דליפת סודות לתוך חבילת הדפדפן.
ה-AI משתמש אוטומטית בסודות שלך בעת בניית פיצ’רים:
"Accept payments with Stripe"→ משתמש ב-STRIPE_SECRET_KEYשלך"Send emails with Resend"→ משתמש ב-RESEND_API_KEYשלך"Add Google OAuth"→ משתמש ב-GOOGLE_CLIENT_IDוב-GOOGLE_CLIENT_SECRETשלך
הסודות נגישים רק בפונקציות ה-backend של Convex (actions ו-mutations), ולא בקוד React ה-frontend. ה-AI מייצר פונקציות Convex שקוראות אותם דרך process.env.
האם ניתן לצפות בסוד או לערוך אותו לאחר יצירתו?
Section titled “האם ניתן לצפות בסוד או לערוך אותו לאחר יצירתו?”ערכי הסודות מוסתרים כברירת מחדל. ניתן להחליף את מצב הצגתם כדי לחשוף את הערכים, לעדכן אותם, או למחוק אותם וליצור מחדש.
האם ה-AI יכול לראות את הסודות שלי?
Section titled “האם ה-AI יכול לראות את הסודות שלי?”ה-AI יכול לראות את שמות הסודות שלך, אך לא את ערכיהם. הדבר מאפשר לו להתייחס למשתה הסביבה הנכון בעת בניית פיצ’רים, מבלי לחשוף נתונים רגישים.
זיהוי מפתחות רגישים
Section titled “זיהוי מפתחות רגישים”Proyecta מזהה אוטומטית תבניות נפוצות של מפתחות רגישים (מפתחות API, טוקנים, סיסמאות) ומסתיר את ערכיהם בממשק המשתמש.
מטא-נתוני האתר
Section titled “מטא-נתוני האתר”החלק SEO & sharing מאפשר לך להגדיר:
- Site title — מופיע בלשונית הדפדפן ובתוצאות החיפוש
- Site description — משמש לתיאורי מטא עבור SEO
- Favicon — הסמל המוצג בלשוניות הדפדפן
הגדרות אלה נשמרות בפרויקט שלך ומוחלות בעת הפרסום.
בסיס ידע
Section titled “בסיס ידע”החלק Knowledge Base מאפשר לך להוסיף חומרי עזר והקשר שה-AI משתמש בהם בעת בניית האפליקציה שלך. הוסף הנחיות מיתוג, מפרטים טכניים, או כל תיעוד אחר שעוזר ל-AI לקבל החלטות טובות יותר.
שאלות נפוצות
Section titled “שאלות נפוצות”האם הסודות מוצפנים?
הסודות מאוחסנים בפרויקט שלך ומסונכרנים ל-deployment של Convex. הם לעולם לא מופיעים בקוד שנשמר ב-commit.
האם ניתן להגדיר סודות שונים לסביבת פיתוח וסביבת production?
כיום, הסודות חלים גם על סביבת ה-runtime בפיתוח וגם על ה-deployment של Convex שפורסם (production). ניהול סודות לפי סביבה מתוכנן לגרסה עתידית.
מה לעשות אם חשפתי סוד בטעות?
מחק מיד את הסוד הישן, בטל את המפתח אצל ספק הצד השלישי, וצור מפתח חדש.
מה ההבדל בין סודות ל-connectors?
סודות הם משתני סביבה גולמיים שאתה מנהל בעצמך. Connectors הם אינטגרציות מנוהלות שבהן Proyecta מטפל עבורך באחסון הפרטים, האימות, רענון הטוקן ורישום הביקורת. השתמש ב-connectors כשהם זמינים (Stripe, Slack, Resend, ElevenLabs); השתמש בסודות עבור שירותים שעדיין אין להם connector.