Skip to content

Latest commit

 

History

History
81 lines (65 loc) · 4.51 KB

README.md

File metadata and controls

81 lines (65 loc) · 4.51 KB
Raw

Java service account sample

Getting access to the API

In order to give you access Connected Cars will create a service account for you.
A service account has data that looks like the following:

----- BEGIN CONNECTEDCARS INFO -----
iss: [email protected]
aud: https://auth-api.connectedcars.io/auth/login/serviceAccountConverter
kid: XXX
----- END CONNECTEDCARS INFO -----
-----BEGIN RSA PRIVATE KEY-----
YOU_CREATE_THIS
-----END RSA PRIVATE KEY-----

After you receive your service account data you must generate an RSA key pair.
This can be done as follows:

# Here the key is encrypted with aes256
openssl genrsa -aes256 -out private.pem 2048

Note: openssl now requires you to set a pass phrase for your private key, which you have to enter when running the above command. This is used to encrypt the key.
To create an unencrypted key, do the following (you will be prompted for your pass phrase):

openssl rsa -in private.pem -out private_unencrypted.pem

Then generate public key from the unencrypted private key:

openssl rsa -in private_unencrypted.pem -outform PEM -pubout -out public.pem

Now put your unencrypted private key into the RSA key block of your service account data. Then send Connected Cars your public key. After confirmation from Connected Cars you will have access to the staging environment.
After confirming that you can call the staging API you can get access to the production API.

Installation

From this directory run gradle build

Usage

This example shows how to use the Connected Cars GraphQL API. A ConnectedCarsApi class is provided under io.connectedcars.api. The Config class from io.connectedcars.sample shows how to make a singleton of the ConnectedCarsApi class, which can be used throughout your project. This means you don't have to query the Connected Cars auth API every time you want to call the GraphQL API.

The Config class loads the Connected Cars service account data from a file, but this could of course be substituted by querying a database, by having the entirety of the service account data in an environment variable, or whatever else you choose. It is also in the Config file that you set your organizationNamespace, please ask Connected Cars for more info.

Connected Cars has two different environments you can call: a staging and a production environment. To change endpoint you change the CC_API_ENDPOINT and the CC_AUTH_API_ENDPOINT environment variables which are used in the Config class. In this sample the environment variables are set through build.gradle in the root. This is also where you find the ORGANIZATION_NAMESPACE environment variable. This is used to specify organization and namespace on your requests. Ask Connected Cars for more info.

How to use the API is shown in the Sample class in io.connectedcars.sample. You get the API from the Config class, to make sure you use the same instance of the class everywhere in your project. Then you can call the API by invoking the call method like so:

public static void main(String[] args) {
        try {
            ConnectedCarsApi CCApi = Config.getCCApi();
            String result = CCApi.call("query Viewer { viewer { id email firstname } }");
            System.out.println(result);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

The ConnectedCarsApi Class takes care of converting your serviceaccount info into a token, the caching of the token, and refreshing your token.

Try out the example against the staging environment

If your service account file is named connectedcars_serviceaccount.pem and is in the root of the project then you don't have to change anything. Otherwise, find the path to your Connected Cars service account file and enter it into the environment variable SERVICE_ACCOUNT_KEY_FILE in the build.gradle in the root.

Start the example with gradle sample. This will query your user details and print them.

To call the production environment simply change the endpoints in build.gradle in the root. The production endpoints are: auth: https://auth-api.connectedcars.io/auth/login/serviceAccountConverter api: https://api.connectedcars.io/graphql

IntelliJ IDEA

You should be able to import the folder full-example as an existing gradle project in IntelliJ and simply have everything set up for you for through the built-in gradle setup. You can then run the sample task through gradle in IntelliJ as well.

TODO: Include information about the GraphQL API itself.