Skip to content

Commit 476bdea

Browse files
authored
docs: update authentication documentation with cookie secure and same-site instructions (#43994)
1 parent 0701fff commit 476bdea

File tree

1 file changed

+26
-1
lines changed

1 file changed

+26
-1
lines changed

docs/deploying-airbyte/integrations/authentication.md

+26-1
Original file line numberDiff line numberDiff line change
@@ -100,4 +100,29 @@ If you are deploying to your own Kubernetes cluster, run:
100100
kubectl apply -f secret.yaml -n <YOUR_NAMESPACE>
101101
```
102102

103-
You may need to restart the airbyte-server pod for the changes to take effect.
103+
You may need to restart the airbyte-server pod for the changes to take effect.
104+
105+
## Cookie Security Settings
106+
107+
### Disabling Secure Cookies
108+
For users running Airbyte on a non-localhost domain without HTTPS, secure cookies cannot be set. To disable secure cookies, update your `values.yaml` file with the following snippet:
109+
110+
```yaml
111+
global:
112+
auth:
113+
cookieSecureSetting: "false"
114+
```
115+
This setting should only be used if HTTPS is not available, as it reduces security by allowing cookies to be transmitted over non-secure connections.
116+
117+
### Modifying Cookie SameSite Setting
118+
By default, Airbyte uses a `cookieSameSiteSetting` of `"Strict"`. If you need to allow cookies to be sent in a cross-site context, you can change this setting to `"None"`. Update your `values.yaml` file with the following:
119+
120+
```yaml
121+
global:
122+
auth:
123+
cookieSameSiteSetting: "None"
124+
```
125+
126+
Note: Setting `cookieSameSiteSetting` to `"None"` may be necessary for certain integrations but should be used cautiously as it can make your application more susceptible to CSRF attacks. Make sure other security measures are in place if you configure this setting.
127+
128+
These changes will take effect the next time you deploy Airbyte using your updated `values.yaml` file.

0 commit comments

Comments
 (0)