Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: rename whitelist to allowlist [DHIS2-10247] #141

Merged
merged 3 commits into from
Feb 14, 2024
Merged

docs: rename whitelist to allowlist [DHIS2-10247] #141

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
fb82694
docs: rename whitelist to allowlist
Topener Dec 20, 2023
2a4d445
Merge branch 'main' into cors-allowlist-rename
Topener Feb 14, 2024
f00a1ce
docs: add namechange note
Topener Feb 14, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/dev-videos.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,13 @@ This is a compilation of technical videos that we have recorded during academies
### Web Development

| **Title** | **Type** | **Audience** | **Topics** | **Date** | **Version** |
|---------------------------------------------------------------------------------------|----------|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|-------------|
| ------------------------------------------------------------------------------------- | -------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------- |
| [App Management improvements](https://youtu.be/Uf3fD7VpNyM) | Webinar | New and experienced developers | New App Management app new features | Nov 2021 | v2.37 |
| [App Hub improvements](https://youtu.be/GtWaKskFEKk) | Webinar | New and experienced developers | App Hub redesign, guidelines and walk-through | Nov 2021 | v2.37 |
| [Personal Access Tokens - PAT](https://youtu.be/Jb6XWIspGto) | Webinar | New and experienced developers | Personal access token creation and management in DHIS2 (part of a larger webinar) | Nov 2021 | v2.37 |
| [App Platform v8 and our new Developer Advocate](https://youtu.be/q-m2sk-xLrY) | Webinar | New and experienced developers | Latest features of @dhis2/cli-app-scripts, @dhis2/app-runtime, and @dhis2/ui | Nov 2021 | v2.37 |
| [Application Development Overview](https://youtu.be/WP6ZWbsTz-Q) | Workshop | New developers | Application development overview | Mar 2021 | |
| [CLI installation](https://youtu.be/vXYgML68Jz4) | Workshop | New developers | CLI Installation, App Initialization, CORS whitelist and live instance debugging | Mar 2021 | |
| [CLI installation](https://youtu.be/vXYgML68Jz4) | Workshop | New developers | CLI Installation, App Initialization, CORS allowlist and live instance debugging | Mar 2021 | |
| [UI Library, Design system and Storybook documentation](https://youtu.be/Brvi4DsIRN8) | Workshop | New developers | UI Library, Design system and Storybook documentation | Mar 2021 | |
| [Data Model REST API](https://youtu.be/F95LTzAzESQ) | Workshop | New developers | DHIS2 REST API Overview, Data Model, API handling in the Android SDK | Mar 2021 | |
| [App Runtime Introduction](https://youtu.be/pvIppH5plMU) | Workshop | New developers | App Runtime intro: hooks, queries, mutations | Mar 2021 | |
Expand All @@ -35,7 +35,7 @@ This is a compilation of technical videos that we have recorded during academies
### Android Development

| **Title** | **Type** | **Audience** | **Topics** | **Date** | **Version** |
|-------------------------------------------------------------------------------------|----------|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|-------------|
| ----------------------------------------------------------------------------------- | -------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ----------- |
| [Android SDK Overview](https://youtu.be/ObdYRiB2s3Y) | Workshop | New developers | Android SDK (1.0) capabilities overview | Mar 2021 | |
| [Skeleton App Overview](https://youtu.be/WuQBm_D7lBU) | Workshop | New developers | Android skeleton app libraries and demo | Mar 2021 | |
| [SDK Installation](https://youtu.be/4dRpgY9sdso) | Workshop | New developers | Android SDK instantiation | Mar 2021 | |
Expand Down
0 docs/guides/assets/cors-whitelist.gif → docs/guides/assets/cors-allowlist.gif
View file
Open in desktop
File renamed without changes
16 changes: 10 additions & 6 deletions docs/guides/debug-instance.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,25 +5,29 @@ title: How to debug common development errors

If you encounter some errors when trying to connect to your application or during development, please try the following troubleshooting steps:

## CORs whitelist
## CORs allowlist

If you run into Cross-Origin Resource Sharing (CORs) policy issues when connecting to your server, you could start with the **CORs whitelist**.
:::note Name Change
Since DHIS2 version 41 it's called **CORs allowlist**. Before that, it was called **CORS Whitelist**.
:::

If you run into Cross-Origin Resource Sharing (CORs) policy issues when connecting to your server, you could start with the **CORs allowlist**.

### What is the CORs whitelist?
### What is the CORs allowlist?

In a DHIS2 instance, by default only web applications that are running on the same URL can access that DHIS2 instance.

There's a **CORs whitelist** option that can be configured to add other URLs besides the current one and allow that DHIS2 application instance.
There's a **CORs allowlist** option that can be configured to add other URLs besides the current one and allow that DHIS2 application instance.

### Where do I change it?

When you login to your instance, click on the apps icon and search for **System Setting** application. Then go to **Access** from the menu on the left and scroll down to see the **CORs whitelist** option.
When you login to your instance, click on the apps icon and search for **System Setting** application. Then go to **Access** from the menu on the left and scroll down to see the **CORs allowlist** option.

There you can add the URLs that you want to grant access. The settings will be automatically updated by tabbing out of that.

See below:

![](./assets/cors-whitelist.gif)
![](./assets/cors-allowlist.gif)

## If you're using Chrome

Expand Down