> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260626-1023.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth

title: התחברות
description: "התחבר ל-FailproofAI מה-CLI כדי להפעיל תזכורות ותכונות מותאמות אישית"
----------------------------------------------------------------------------------

```bash theme={null}
failproofai auth login    # email + one-time code
failproofai auth logout   # revoke this session
failproofai auth whoami   # print the signed-in identity
```

צורת הדגל הישנה `--login` / `--logout` / `--whoami` עדיין מתקבלת כקנייה לתאימות לאחור.

האימות הוא אופציונלי. מדיניות, לוח הבקרה, דף `/audit` וכל תכונה מקומית אחרת פועלים בדיוק באותו אופן בין אם אתה מחובר או לא. משטח ההתחברות קיים כדי שתכונות ש**צריכות** זהות יציבה (תזכורות re-audit כיום, עוד בעתיד) יהיו למקום לעוגן.

## זרימת התחברות

```bash theme={null}
failproofai auth login
```

מבקש את הדוא"ל שלך, שולח קוד חד-פעמי בן 6 ספרות לכתובת זו, מבקש את הקוד, ובהצלחה כותב `~/.failproofai/auth.json` (מצב `0600`). אותה הסדר כניסה גלויה לאחר מכן בלוח הבקרה המובנה — לחיצה על `[ set a reminder ]` ב-`/audit` תראה אותך כמחובר.

לוח הבקרה חושף את אותה הזרימה כתיבת דיאלוג מודאלית ב-`/audit` למשתמשים שלעולם לא נוגעים ב-CLI.

## התנתקות

```bash theme={null}
failproofai auth logout
```

מבטל את הסדר הנוכחי בשרת ומוחק את `~/.failproofai/auth.json`. אם שרת ה-API אינו זמין, הקובץ המקומי מוסר בכל מקרה — כוונה מקומית להתנתקות תמיד מנצחת.

## בדיקת זהות

```bash theme={null}
failproofai auth whoami
```

הדפס `<email> (<user uuid>)` וצא עם קוד 0 כאשר סדר כניסה תקין קיים, או `not signed in` וצא עם קוד 1 אחרת. מרענן בשתיקה את אסימון הגישה ברקע אם הוא בטווח של דקה מלהיות תוקף שלילי.

## תזכורת re-audit קבועה

כאשר אתה לוחץ על **`[ set a reminder ]`** בדף `/audit` (או מתחבר דרך המודאל שהכפתור משער), לוח הבקרה כותב קובץ קטן מלווה ב-`~/.failproofai/next-audit.json`:

```json theme={null}
{
  "next_audit_at": 1780765200,
  "user_email": "you@example.com",
  "set_at": 1780160574
}
```

קובץ זה מוגבל לדוא"ל שעליו הוגדר — החלפת הסדר כניסה של CLI לחשבון אחר מסתירה כל תזכורת ששייכת למשתמש הקודם. התזה ברירת מחדל היא **7 ימים**, הניתנת להגדרה מאוחר יותר כאשר המתזמן נוחת. נוצר עם הרשאות `0600` כמו `auth.json`.

נקודת הקצה `/api/auth/reminder` של לוח הבקרה חושפת `GET` (קריאה), `POST` (הגדרה / תזמון מחדש) ו-`DELETE` (ניקוי) וידרוש סדר כניסה פעיל.

## מה נמצא ב-`~/.failproofai/auth.json`

```json theme={null}
{
  "access_token": "eyJhbGc…",
  "refresh_token": "9ede3e…",
  "access_expires_at": 1780160574,
  "refresh_expires_at": 1782748974,
  "user": { "id": "<uuid>", "email": "you@example.com" }
}
```

נוצר עם הרשאות `0600` (קריאה/כתיבה של בעלים בלבד). אסימון הגישה הוא JWT HS256 של שעה אחת; אסימון ההרענון הוא מחרוזת אקראית אטומה של 256 סיביות שהשרת מאחסן כ-`SHA-256(token)`. השדול של אסימון הרענון מגוקח בצד השרת ומבטל כל סדר כניסה למשתמש.

## משתנים סביבה

| משתנה                  | ברירת מחדל                   | מטרה                                                                                 |
| ---------------------- | ---------------------------- | ------------------------------------------------------------------------------------ |
| `FAILPROOF_API_URL`    | `https://api.befailproof.ai` | עקוף את כתובת ה-URL של בסיס שרת ה-API. שימושי להנדסה מקומית כנגד שרת api מתארח עצמי. |
| `FAILPROOFAI_AUTH_DIR` | `~/.failproofai`             | עקוף היכן `auth.json` מאוחסן. בעיקר לבדיקות.                                         |

ראה [משתנים סביבה](/he/cli/environment-variables) לרשימה המלאה.

## פתרון בעיות

**"Could not reach the api-server"** — ה-CLI לא יכול לפתוח חיבור TCP ל-`FAILPROOF_API_URL`. בדוק את הרשת שלך, או הגדר `FAILPROOF_API_URL` אם אתה מפעיל שרת api מתארח עצמי.

**"Rate limited"** — יותר מדי ניסיונות התחברות בחלון של 15 דקות לאותו הדוא"ל (5/email) או IP (20/IP), או קיבוע של 30 שניות לשיליחה מחדש לאחר הבקשה הקודמת לאותו הדוא"ל. הודעת השגיאה כוללת את חלון retry-after בשניות.

**Code rejected** — ה-OTP היה שגוי, פג תוקפו, או השורה פגעה בנעילה של 5-ניחוש שגוי שלה. הפעל `failproofai auth login` שוב כדי לבקש קוד טרי.