מתקינים את NotHoly בעורך שלך.

1. 1/5

   מתקינים מתוך העורך

   מחפשים NotHoly.com בחלונית התוספים ולוחצים Install, או מריצים את הפקודה הזו. VS Code מתקין מ-Visual Studio Marketplace; Cursor, Windsurf ו-VSCodium מתקינים מ-Open VSX. העדכונים מגיעים דרך העורך, אז מדלגים על שני השלבים הבאים.

   התקנה מ-Open VSX
   VS CodeCursorWindsurfVSCodium

   העתקה

   code --install-extension NotHolycom.notholy

2. 2/5

   או מורידים את קובץ ה-vsix

   כדי לבדוק את הקובץ, מריצים את הפקודה של המערכת שלך בתיקייה שבה הוא נשמר ומשווים את הפלט ל-SHA-256 שלמטה.

   הורדת קובץ vsixגרסה 0.1.3

   SHA-256

   00d430ea591f0a3dcac93abd8daaf7933c5d53736d86fe5ea26af7081ad9df5a
   WindowsmacOSLinux

   העתקה

   Get-FileHash notholy-vscode-latest.vsix -Algorithm SHA256

3. 3/5

   מתקינים

   בחלונית Extensions פותחים את התפריט ... למעלה, בוחרים Install from VSIX ובוחרים את הקובץ. אפשר גם להריץ את הפקודה הזו בתיקייה שבה הקובץ נשמר.

   VS CodeCursorWindsurfVSCodium

   העתקה

   code --install-extension notholy-vscode-latest.vsix

4. 4/5

   נכנסים לחשבון

   פותחים את Command Palette (‏Ctrl+Shift+P, או Cmd+Shift+P ב-macOS) ומריצים NotHoly: Sign in, או לוחצים על ✦ NotHoly בשורת המצב. התראה מציגה קוד והדפדפן פותח את notholy.com/activate. נכנסים לחשבון אם צריך, בודקים את הקוד, בוחרים ארגון ומאשרים. המפתח נשמר באחסון הסודות של העורך. אין שדה להדבקת מפתח. ב-CI מגדירים NOTHOLY_API_KEY בסביבה שמפעילה את העורך.

   >NotHoly:

   • NotHoly: Sign inEnter

5. 5/5

   מוודאים שזה עובד

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

   • ✦ $12.34 · model

     מחובר. היתרה שלך והמודל שבשימוש.

   • ✦ NotHoly

     לא נכנסת לחשבון, או שה-API לא ענה. מעבירים את העכבר מעליו וה-tooltip מציין מה מהשניים.

Cursor, Windsurf ו-VSCodium משתמשים באותו תוסף דרך Open VSX. הבדיקות האוטומטיות שלנו רצות רק ב-VS Code, ולכן לא בדקנו בשלושת אלה. כשנכנסים מאחד מהם, דף האישור עדיין מציג VS Code.

• צ׳אט בתצוגה בסרגל הצד. מזכירים קובץ מסביבת העבודה עם ‎@path והתוכן שלו נשלח עם ההודעה.

• סוקרים קובץ והממצאים מגיעים ל-Problems. קישור לסקירה מופיע מעל שורות שבדרך כלל כדאי לבדוק שוב.

• תיקון מוצע הוא quick fix על הממצא. הוא נפתח כ-diff של שני צדדים, ושום דבר לא משתנה עד שבוחרים Apply.

• שורת המצב מציגה יתרה ומודל. המפתח נשאר באחסון הסודות של העורך, מחוץ להגדרות ולקבצי סביבת העבודה.

NotHoly: Sign in, Sign out

מחברת או מנתקת את העורך הזה.

NotHoly: Explain selection

מסבירה בצ׳אט את הקוד המסומן ומצביעה על מה שנוגע לאבטחה.

NotHoly: Review this file

סוקרת את הקובץ הפתוח לבעיות אבטחה. הממצאים עוברים ל-Problems.

NotHoly: Review changes (git diff)

סוקרת בצ׳אט שינויים שלא נכנסו ל-commit, או את אלה שב-stage כשעץ העבודה נקי.

NotHoly: Investigate a CVE

מבקשת מזהה CVE, שולפת את הרשומה ומסבירה השפעה, מצב ניצול ומה לתקן או לזהות.

NotHoly: Write a regression test for the selection

מנסחת בדיקה שהייתה תופסת באג אבטחה בקוד המסומן, בסגנון הבדיקות של הפרויקט.

NotHoly: Write a detection rule for the selection

מנסחת חוק Sigma, Semgrep או YARA לשימוש לרעה בקוד המסומן.

הטרמינל לא מוצא את code

ב-VS Code ל-macOS מריצים Shell Command: Install 'code' command in PATH מ-Command Palette ופותחים טרמינל חדש. אפשר גם לוותר על הטרמינל ולהשתמש בחלונית Extensions.

העורך אומר שהתוסף לא תואם

התוסף צריך עורך שמבוסס על VS Code 1.95 ומעלה. מעדכנים את העורך ומתקינים שוב.

הדפדפן לא נפתח, או שהקוד פג

נכנסים ל-notholy.com/activate ומקלידים את הקוד מההתראה. קוד תקף ל-10 דקות. אחרי זה מריצים שוב NotHoly: Sign in.

שורת המצב עדיין מציגה ✦ NotHoly

מעבירים את העכבר מעליו. Sign in to NotHoly אומר שהמפתח חסר או בוטל, אז נכנסים שוב. NotHoly is unreachable מצביע על הרשת או על ה-proxy.

פקודות הסקירה ובדיקת הרגרסיה חסרות

סביבת העבודה לא מהימנה. מריצים Workspaces: Manage Workspace Trust ומסמנים את התיקייה כמהימנה. עד אז סקירות, בדיקות רגרסיה, אזכורי ‎@path וקישורי הסקירה כבויים. צ׳אט, חיפוש CVE, Explain selection וחוקי זיהוי ממשיכים לעבוד על הטקסט שנשלח.

הצ׳אט אומר not enough credits

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

Review changes אומרת No git repository is open

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