Akses Terbatas — implement.gcgscola.id¶
URL: https://implement.gcgscola.id
Tier: implementor — go-live, config guides, UAT klien (mkdocs-internal.yml)
Auth: Cloudflare Access (Zero Trust) — partner implementor + GCG
Domain SSOT, QA, dan audit pindah ke https://dev-docs.gcgscola.id (tim GCG only).
1. Arsitektur¶
Browser → Cloudflare (Access login) → nginx origin (Let's Encrypt) → /var/www/implement.gcgscola.id/
- Origin SSL: Let's Encrypt via certbot di server (
implement.gcgscola.id) - Edge auth: Cloudflare Access — pengguna harus login sebelum request sampai ke origin
- Portal publik (
docs.gcgscola.id) tetap tanpa auth dan tidak berisi konten tier ini
2. Setup Cloudflare Access (dashboard)¶
- Login Cloudflare Zero Trust
- Access → Applications → Add an application
- Tipe: Self-hosted
- Application domain:
- Subdomain:
implement - Domain:
gcgscola.id - Path: kosong (seluruh site)
- Identity providers: Google Workspace (
@gcgscola.id) dan/atau email OTP - Policy — Allow:
- Rule name:
GCG team + implementors - Action: Allow
- Include (contoh):
- Emails ending in
@gcgscola.id - Emails in list (partner implementor per klien)
- Google Groups:
[email protected](jika dipakai)
- Emails ending in
- Policy — Block (default): semua lainnya → deny
- Simpan → uji incognito: harus muncul halaman login Cloudflare sebelum docs
SSL/TLS Cloudflare¶
- SSL/TLS mode: Full (strict) — origin sudah punya sertifikat Let's Encrypt
- Always Use HTTPS: ON
3. Deploy konten (server)¶
cd /home/scola/odoo/scola-fe-v2
./scripts/build-docs.sh internal --install
Deploy path: /var/www/implement.gcgscola.id
4. Nginx + SSL (origin)¶
Pertama kali:
sudo cp /home/scola/odoo/config/nginx/implement.gcgscola.id.http-only.conf \
/etc/nginx/sites-enabled/implement.gcgscola.id
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d implement.gcgscola.id
curl -I https://implement.gcgscola.id
Template HTTPS: config/nginx/implement.gcgscola.id.conf
5. Checklist go-live tier implementor¶
- [ ] DNS
implement.gcgscola.id→ origin (Cloudflare proxy ON) - [ ]
./scripts/build-docs.sh internal --install - [ ] Nginx vhost + certbot SSL aktif
- [ ] Cloudflare Access policy aktif (uji incognito)
- [ ] Cloudflare SSL mode Full (strict)
- [ ] Tab Implementator, Domain Teknis, Audit tidak ada di
docs.gcgscola.id
6. Troubleshooting¶
| Gejala | Penyebab | Solusi |
|---|---|---|
| 404 dari Cloudflare | Nginx vhost belum ada | Aktifkan vhost + deploy static |
| 525 SSL handshake | Origin tanpa sertifikat | Jalankan certbot |
| Docs tampil tanpa login | Access belum dipasang | Tambah application di Zero Trust |
| Link canonical salah | site_url MkDocs |
Pastikan mkdocs-internal.yml → https://implement.gcgscola.id |
Lihat juga: docs-site-deployment.md