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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions