# 6.2.2. DHIS2 credentials

GeoPrism Registry supports logging in with DHIS2 credentials using OAuth 2.0 for a specific DHIS2 instance.

{% hint style="info" %}
To log in with this method, a user must first exist in both GeoPrism Registry and the DHIS2 instance with the same username, and the GeoPrism Registry user must have OAuth enabled. For more information about creating or configuring GeoPrism Registry users to use OAuth, see [section 6.3](/readme/current/geoprism-registry-tutorial/6.3-user-management.md).
{% endhint %}

{% hint style="info" %}
This requires the DHIS2 instance to be registered as an external system in GeoPrism Registry.
{% endhint %}

1. Ensure that the DHIS2 instance you want to use to connect is registered as an external system in GeoPrism Registry (see [section 4](/readme/current/external-system-integration.md)).
2. From the GeoPrism Registry login page, click the **Log in with DHIS2** button.\\

   <figure><img src="https://lh5.googleusercontent.com/AXAUGJ48WzTZ1C4hpzBfN4xgiao_gneE9Qn70zqN8lXUy0RgvdO_-xiTmgS8eUyYCBVaAw-vINt74oVwSycNkSaOIBLvk9VxT2ASWZn_TwvruJHl2UhSIyCazbnoi6rTbxCa8L_cyqTtdWyVBM6cxXJvOCkVdzYah_0-7n98Lrzr-2qCz7lBqucR" alt=""><figcaption></figcaption></figure>
3. If there is more than one DHIS2 external system registered, a dropdown will appear of all the registered DHIS2 instances. Select the instance you want to use to log in with, which will route you to the login screen of that instance. If there is only one system, you will be routed to the login screen of that instance without needing to select that instance from a dropdown.\\

   <figure><img src="https://lh3.googleusercontent.com/_G0cZal4S6oKRWM9VpnneSspLnaWQAzpT8nOqD2hPmuJljYEkaioiSojqd65OXll8XvloLxy9p3AhrhzQXM6Am7Y1GlXn247BWrztT4KrT8Jxlxj74-Cxdh8i-9UUHNLTCFagivBrhjjQV6daOJ0uEw57ccm1_6o6vfCoQMURB6X11PCfuOISLno" alt=""><figcaption></figcaption></figure>
4. Log in to the DHIS2 instance. Once logged in, you will be asked to authorize GeoPrism Registry ('georegistry'). Click **Authorize** to continue.\\

   <figure><img src="https://lh4.googleusercontent.com/ICTjXYND51ZhyqMA8oSIUnM0yQn7lztBqouGpdDmVCdCHoIEeAt3JEs3UUyWn1HPuqzTMMCH3x4RpFnd3NvlYHMA0xHyEQiCv6uXd_TVg89tF02p275T7BQ2BShsq9QVw-tJ-KTMiCceCTZMrajH4QxmSD7dTZmuASlrKxH31k9CAV5iYt8ZjFMQ" alt=""><figcaption></figcaption></figure>
5. After clicking **Authorize** you will have access to the GeoPrism Registry instance you started with.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.geoprismregistry.com/readme/current/geoprism-registry-tutorial/6.2-logging-in/6.2-logging-in-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.