בירור | איזה כתובות התוכנה משתמשת

[יוסי כהן]

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

Spoiler

כדאי שיהיה כזה תגית בנטפרי, אם מישהו יוכל לעזור בזה גם.

[Otzaria-Bot]

הכתובות שאוצריא פונה אליהן (אומת בקוד ענף dev, 28/10/2026):

ליבה — חובה לאישור:

• api.github.com — כל בדיקות העדכון: גרסת התוכנה, הספרייה, הקטלוג, המילון, הביוגרפיות והווקטורים. גם בדיקת הקישוריות עצמה נעשית מולו (update_source_reachability.dart).
• github.com — כתובות ההורדה של קבצי ה-Releases.
• release-assets.githubusercontent.com — היעד בפועל של כל הורדת קובץ. GitHub מפנה לשם ב-redirect, ולכן אישור של github.com בלבד לא מספיק: הבדיקה תעבור וההורדה תיכשל. כדאי לאשר גם את objects.githubusercontent.com (הדומיין הישן לאותה מטרה).
• otzaria.org — חנות התוספים, בדיקת עדכוני תוספים (/api/plugins/updates) ודיווחי שגיאה (/api/reportingerrors, /api/app-reports, /api/plugin-reports).

לתוספים מותקנים:

• raw.githubusercontent.com — חלק מהתוספים מושכים ממנו נתונים.
• מעבר לזה, לכל תוסף יש allowlist רשת משלו עם כתובות מלאות — תלוי אילו תוספים מותקנים אצלך. הרשימה המלאה: lib/plugins/models/plugin_network_allowlist.g.dart ברפו.

אופציונלי:

• o4510914530902016.ingest.us.sentry.io — דיווחי קריסה. חסימתו לא פוגעת בתפקוד.

<details>
<summary>אם הסינון מאפשר דיוק ברמת נתיב — המאגרים שנשאלים בפועל</summary>

• Otzaria/otzaria — גרסת התוכנה
• Otzaria/SeforimLibrary — הספרייה, טלאים דיפרנציאליים ווקטורים
• Otzaria/otzaria-library — תלמוד בבלי ונכסים נלווים
• Otzaria/otzar-HB_catalog — קטלוג אוצר החכמה
• Otzaria/SeforimMagicIndexer — מילון לקסיקלי
• Otzaria/toldot-gedolei-yisrael — קובץ הביוגרפיות
• Otzaria/otzaria-semantic-search — מודל החיפוש החכם

</details>

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

[יוסי כהן]

@Otzaria-Bot
אני רוצה שהאישור יהיה מדוייק רק לכתובות הנצרכות ולא לכתובות כלליות יותר שיפתחו לי עוד דברים [כמו גיט לדו'].

[Otzaria-Bot]

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

api.github.com — רק הנתיבים האלה (מחזירים JSON של מידע על Releases, לא קוד):

• https://api.github.com/ — בדיקת נגישות שרת העדכונים בלבד (update_source_reachability.dart)
• https://api.github.com/repos/Otzaria/otzaria/releases (וגם /latest ו-/tags/<תג>) — גרסת התוכנה
• https://api.github.com/repos/Otzaria/SeforimLibrary/releases/latest וגם /releases/tags/<תג> — ספרייה, טלאים דיפרנציאליים ווקטורים
• https://api.github.com/repos/Otzaria/otzaria-library/releases/latest — תלמוד בבלי ונכסים נלווים
• https://api.github.com/repos/Otzaria/otzar-HB_catalog/releases/latest — קטלוג אוצר החכמה
• https://api.github.com/repos/Otzaria/SeforimMagicIndexer/releases/latest — מילון לקסיקלי
• https://api.github.com/repos/Otzaria/toldot-gedolei-yisrael/releases/latest — קובץ הביוגרפיות
• https://api.github.com/repos/Otzaria/otzaria/contents/plugin_network_allowlist.txt?ref=dev — רשימת הרשאות הרשת של התוספים

github.com — רק נתיבי ההורדה, לא הדומיין:

• https://github.com/Otzaria/otzaria/releases/download/
• https://github.com/Otzaria/SeforimLibrary/releases/download/
• https://github.com/Otzaria/otzaria-library/releases/latest/download/
• https://github.com/Otzaria/otzar-HB_catalog/releases/latest/download/
• https://github.com/Otzaria/SeforimMagicIndexer/releases/latest/download/
• https://github.com/Otzaria/otzaria-semantic-search/releases/download/model-meivin-round2-int8-v1
• https://github.com/Otzaria/toldot-gedolei-yisrael/releases/download/

אישור ברמת הנתיבים האלה לא פותח דפדוף בגיטהאב, לא חיפוש ולא git clone.

raw.githubusercontent.com — שני נתיבים בלבד:

• https://raw.githubusercontent.com/Otzaria/otzaria/dev/plugin_network_allowlist.txt
• https://raw.githubusercontent.com/Otzaria/otzaria/refs/tags/ — יומן השינויים שמוצג בדיאלוג העדכון

otzaria.org — נתיבים:

• https://otzaria.org/ — בדיקת קישוריות
• /api/plugins/updates + נתיב ההורדה של קובץ התוסף (יחסי, מהחנות)
• /api/reportingerrors, /api/app-reports, /api/plugin-reports — דיווחי שגיאה
• /api/search-feedback/register, /api/search-feedback/events

היעד היחיד שאי אפשר לדייק: release-assets.githubusercontent.com

github.com/.../releases/download/... מחזיר הפניה (redirect) לכתובת חתומה עם נתיב אקראי שמשתנה בכל בקשה, ולכן חייבים לאשר את ה-host כולו. זה לא פותח "עוד דברים": ה-host הזה מגיש רק את הבייטים של נכסי Releases — אין בו ממשק, דפדוף, gist או git. כדאי להוסיף גם את objects.githubusercontent.com (הדומיין הישן לאותה מטרה). במפורש לא צריך: codeload.github.com, gist.github.com, *.github.io, gitlab — אוצריא לא פונה אליהם.

<details>
<summary>אופציונלי ותוספים</summary>

• o4510914530902016.ingest.us.sentry.io — דיווחי קריסה. חסימתו לא פוגעת בתפקוד.
• תוספים מותקנים: לכל תוסף allowlist משלו בכתובות https מלאות (ללא wildcards), והתוכנה מאמתת מול plugin_network_allowlist.txt שבענף dev. לאשר רק את הכתובות של התוספים שמותקנים אצלך בפועל.
  </details>

אומת בקוד ענף dev, 28/10/2026.

[יום חדש מתחיל]

@Otzaria-Bot כתב:

https://api.github.com/ — בדיקת נגישות שרת העדכונים בלבד (update_source_reachability.dart)

אולי בשביל שהציבור השמור לא יצטרך לפתוח את כל כתובות ה API של גיטהאב ס"ה רק בשביל בדיקה האם שרת העדכון פתוח,
כדאי לשנות את הקוד שיבדוק את https://api.github.com/repos/Otzaria/
@פלמנמוני

[צדיק וטוב לו]

@יוסי-כהן כתב:

כדאי שיהיה כזה תגית בנטפרי, אם מישהו יוכל לעזור בזה גם.

רעיון יפה.
@י.-פל. יש סיכוי? מי עמד איתם בקשר עד היום?