Skip to content

Connect to Astra DB - Token authentication #4856

@aimurphy

Description

@aimurphy

Hello,

I am a technical writer for DataStax. I am leaving some feedback on the JanusGraph documentation for Astra DB because I'm not sure if I need to sign the contributor agreement to submit a docs PR.

ClientID + Secret are legacy

ClientID and secret are a legacy authentication pattern for Astra.
The modern pattern is token + the application token itself (which starts with the prefix AstraCS:..).

The change to the documentation is minimal:
username is set to the literal string token, and password is set to the application token.

In janusgraph-cql.properties:

storage.username=token
storage.password=<application token>

In astra.conf:

    username = "token"
    password = "<application token>"

SCB prerequisite link outdated

The sentence directing the user to download the SCB uses an old link.

In light of the above change to username/password, I suggest the following changes:

  • Remove this note:

    Note: Client id and Client secret need to be generated and copied from your Astra Account as per this [doc](https://docs.datastax.com/en/astra/docs/manage-application-tokens.html).
    
  • Revise the prerequisite sentence:

    [Download the Secure Connect Bundle (SCB)](https://docs.datastax.com/en/astra-db-serverless/databases/secure-connect-bundle.html) for your Astra database, and [generate an application token](https://docs.datastax.com/en/astra-db-serverless/administration/manage-application-tokens.html) with permission to read and write to your database.
    

Java driver manual outdated link

Edited the issue to add that the Java driver manual link under storage.cql.internal is for v 4.13 but the pom has 4.17.

Note that versions 4.18+ are maintained by the ASF. Work is underway to publish documentation for 4.18+.
You can find links in the Driver version column here: https://docs.datastax.com/en/datastax-drivers/compatibility/java-drivers.html#java-driver-4-x-series-compatibility

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions