Configuring client credentials
Setup your client credentials for use with the Agent and Python client
Creating a Pennsieve API key and secret
To create an API key/secret pair, log in to Pennsieve and navigate to your profile settings. You can do this by clicking the circular icon with your initials in the bottom-left corner of the site to navigate to your View My Profile page.
In the profile page click on the *Create API Key button and provide an meaningful name to this specific key/secret pair. For example, you can call it: "My Macbook Pro Key".
After that you’ll see a dialog with your new API key/secret pair.
Important note
Make sure to save your new API key/secret pair before exiting the dialog! For security purposes, you will not be able to view the key/secret again. You can always generate a new API key/secret in case you no longer have access to your old one.
Creating a Pennsieve configuration file
The first step is to configure the agent to use your Pennsieve account by registering an API key/secret. Use the Pennsieve web application to generate API credentials
The agent configuration is built based on a config file stored in ~/.pennsieve/config.ini
.
Navigate to the folder where the Pennsieve Agent is installed. Look here for the default locations for each operating system. Now, use the config wizard command to create a new config file. Provide a name for your new profile and the API key and secret that you created in the web application.
pennsieve config wizard
New profiles can be added to your configuration file using the profile create command.
pennsieve profile create
Create a new profile:
Profile name: [default] myProfile
API token: xxxx
API secret: xxxx
If the newly selected profile is not selected as the active profile, use the profile switch command to switch the active profile to the newly created profile. To verify you can access your account, use the whoami command to request some information about your Pennsieve account.
pennsieve whoami
+-----------------+-----------------------------------------------------+
| NAME | [email protected] |
| USER ID | N:user:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| ORGANIZATION | User Oganization |
| ORGANIZATION ID | N:organization:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
+-----------------+-----------------------------------------------------+
Updated 5 months ago