Asana configuration

Creating connection to Asana

This only applies if you are hosting ManicTime Server yourself. It does not apply if you are using ManicTime Cloud.

Before users can make a connection to Asana to get projects, ManicTime Server needs to be connected to Asana.

1. On Asana, go to Asana developer console. Then click on the Create new app.

Asana developer console

2. Got o OAuth Tab where you will need to Add redirect URL. To get the Authorization callback url for the Redirect URL field, go back to ManicTime server, Administration and under Asana configuration, you will see a list of possible Redirect URIs.

OAuth tab

Possible redirect URIs

4. Click + Add redirect URL button and copy one of them from ManicTime Server.

5. Copy Client ID and secret to ManicTime Server Asana Connection Configuration screen.

Copy Client Id and Secret to ManicTime Server Asana Configuration screen

6. Click "Test connection" to see if the connection is set properly, then save it.

When you click "Test connection", you will go through the authentication process, like all users who will try to connect to Asana.

Creating initial connection to Asana

Initial connection is needed to make a connection to Asana. After initial connection is made, each user can then create a connection. To create initial connection to Asana, an Administrator needs to go to Administration -> Connections -> Connection configuration. Click Configure and you will be redirected to Asana login page. After a successful login you will be redirected to Connection settings.

Connection settings

• Authenticated user - specific user account that is used to authenticate and query data from Asana. This user will be used to get all the data.
• Starting tags - Tags which will be preceding the tags from Asana. This can help with distinguishing tags coming from Asana.

Creating connection to Asana

After initial connection is made, each user can then connect to Asana.