Oʻz serveringizda Gmail va Outlook pochtasini ulash

Kimlar uchun: IT administrator (bir martalik roʻyxatdan oʻtkazish) va ish maydoni administratorlari · Vaqt: taxminan 20 daqiqa

Umumiy koʻrinish

Bu ixtiyoriy. Takliflar va bildirishnomalar allaqachon kompaniya pochta serveri orqali yuboriladi. Gmail yoki Outlook ulanganda har bir xodim oʻz pochtasini Digital Workspace ichida oʻqiydi va yuboradi hamda taqvimini sinxronlaydi.

Oʻz serveringizda Gmail bilan davom etish va Outlook bilan davom etish faqat IT administrator serveringiz uchun Google yoki Microsoft’da ilovani roʻyxatdan oʻtkazgandan keyin ishlaydi. Ungacha ulardan birini bosganda Gmail orqali kirish bu serverda hali yoqilmagan (yoki Outlook) xabari chiqadi, xodimlar esa oddiy ichki pochta qutisidan foydalanishi mumkin.

Boshlashdan oldin

• HTTPS server nomi bilan yoqilgan ("HTTPS ni yoqish" maqolasiga qarang). Google va Microsoft faqat https:// qaytish manzillarini qabul qiladi. Google uchun IP-manzil emas, haqiqiy domen nomi ham kerak.
• Ish maydoni sozlamalari › Pochta serveri boʻlimidagi Veb-manzil HTTPS manzil boʻlishi kerak.
• Pochta qutisi moduli Ish maydoni sozlamalari › Modullar boʻlimida yoqilgan.
• Server internet orqali Google (accounts.google.com, googleapis.com) yoki Microsoft (login.microsoftonline.com, graph.microsoft.com) ga ulana oladi. Oflayn server bu pochta qutilarini ulay olmaydi.

Qaytish manzilingiz (redirect URI)

Ikkala roʻyxatdan oʻtkazish uchun ham shu manzil kerak. Birinchi qismini oʻz veb-manzilingiz bilan almashtiring:

https://workspace.company.uz/api/email/oauth/callback

Outlook / Microsoft 365 (IT administrator)

1. Microsoft Entra admin centerda App registrations → New registration ni oching.
2. Nomini Digital Workspace deb yozing. Supported account types ostida Accounts in this organizational directory only variantini qoldiring. Redirect URI ostida Web ni tanlang va qaytish manzilingizni kiriting. Register tugmasini bosing.
3. Application (client) ID va Directory (tenant) ID ni nusxalang.
4. Certificates & secrets → New client secret ni oching va uning Value qiymatini nusxalang.
5. API permissions → Add a permission → Microsoft Graph → Delegated ni oching va openid, email, profile, offline_access, User.Read, Mail.Read, Mail.Send va Calendars.ReadWrite ruxsatlarini qoʻshing. Grant admin consent tugmasini bosing.

Gmail / Google Workspace (IT administrator)

1. Google Cloud consoleda loyiha yarating va Gmail API ni (taqvimlar uchun Google Calendar API ni ham) yoqing.
2. OAuth consent screen ni sozlang. Kompaniya Google Workspace’i uchun faqat hamkasblaringiz foydalana olishi uchun Internal ni tanlang.
3. Credentials → Create credentials → OAuth client ID ni oching, turini Web application qilib tanlang va qaytish manzilingizni Authorized redirect URIs ostiga qoʻshing.
4. Client ID va Client secret ni nusxalang.

Kalitlarni serverga qoʻshish (IT administrator)

1. Serverda /opt/digital-workspace/.env faylini oching. Kerakli qatorlarni toping, har birining boshidagi # belgisini olib tashlang va = belgisidan keyin qiymatni yozing:
   • MICROSOFT_CLIENT_ID=, MICROSOFT_CLIENT_SECRET= va MICROSOFT_TENANT= (Directory (tenant) ID)
   • GOOGLE_CLIENT_ID= va GOOGLE_CLIENT_SECRET=
2. Oʻzgarishni qoʻllang: cd /opt/digital-workspace && sudo docker compose up -d app.
3. Client secret qiymatlarini maxfiy saqlang. Ularni hech qachon chat yoki emailga joylamang; Microsoft sirlarining muddati tugaydi, shuning uchun sanani yozib qoʻying va sirni muddati tugashidan oldin almashtiring.

Pochta qutisini ulash

1. Har bir xodim Pochta qutisini ochadi va Gmail bilan davom etish yoki Outlook bilan davom etish tugmasini bosadi.
2. Google yoki Microsoft sahifasida tizimga kiradi, ruxsat beradi va Digital Workspace ga qaytadi.

Qolgani "Pochtani sozlash" maqolasida yozilganidek ishlaydi. Takliflar esa avvalgidek kompaniya pochta serveri orqali yuboriladi.

Muammolarni bartaraf etish