# 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](https://docs.geoprismregistry.com/readme/current/geoprism-registry-tutorial/6.3-user-management).
{% 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](https://docs.geoprismregistry.com/readme/current/external-system-integration)).
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.
