Skip to contents

Setting your credentials

This guide outlines how to set your credentials for accessing data from a DHIS2 instance. DHIS2 (District Health Information System 2) is a widely used open-source platform for health data management.To access the data through the khisr package, you need to provide valid credentials.

The khisr package cannot make calls to DHIS2 without credentials, and incorrect credentials will result in an unauthorized error from DHIS2.

This method is recommended for security reasons as it avoids storing credentials directly in your code.

khis_cred(config_path = "/path/to/the/JSON/file.json")

The JSON file should have the following format:

  "credentials": {
    "username": "your-dhis2-username",
    "password": "your-dhis2-password",
    "base_url": "https://<dhis2 api instance>/api"

Alternative Method: Direct Input

If you cannot use a JSON file, you can provide your username and password directly:

khis_cred(username = 'your_username', password = 'your_password', base_url = 'https://<dhis2 api instance>/api')

Additional Functions