Supabase self-hosted kurulumlarda kırıcı değişiklik: API_EXTERNAL_URL artık /auth/v1 istiyor

Supabase, self-hosted (Docker) kurulumlarda API_EXTERNAL_URL ortam değişkeninin varsayılan değerini değiştiriyor: eskiden http://localhost:8000 iken yeni varsayılan http://localhost:8000/auth/v1 oluyor.

Kimler etkileniyor

Üç grup kurulum doğrudan etkileniyor:

1. .env dosyasında API_EXTERNAL_URL’i özelleştirenler (örneğin https://my-domain.com) — bu değerin https://my-domain.com/auth/v1 olarak güncellenmesi gerekiyor.
2. Özel OAuth sağlayıcılı docker-compose.yml kullananlar — redirect URI’lar ${API_EXTERNAL_URL}/auth/v1/callback’ten ${API_EXTERNAL_URL}/callback’e değişiyor.
3. SAML SSO kullananlar — kimlik sağlayıcı (IdP) tarafındaki uç noktalar /sso/saml/*’ten /auth/v1/sso/saml/*’e taşınıyor; IdP’de ACS URL ve SP entity ID’nin yeni uç noktalarla güncellenmesi gerekiyor.

Erteleme mümkün

Supabase bunun bir zorunlu kaldırma değil, bir varsayılan değişikliği olduğunu vurguluyor: mevcut API_EXTERNAL_URL değeri /auth/v1 eki olmadan bırakılırsa eski davranış korunuyor. Ancak ekip, özel OAuth sağlayıcılarının yeni yapılandırma olmadan çalışmayacağını belirtiyor.

Neden önemli

Bulut-barındırmalı Supabase kullanıcıları bu değişiklikten etkilenmiyor — değişiklik yalnızca kendi sunucusunda Docker ile Supabase çalıştıran (self-hosted) kurulumları ilgilendiriyor. Bu tür kurulumlarda bir sonraki imaj güncellemesinden önce OAuth/SAML konfigürasyonunun gözden geçirilmesi, sessizce kırılan bir giriş akışıyla karşılaşmamak için gerekli.