janusgraph icon indicating copy to clipboard operation
janusgraph copied to clipboard

Connect to Astra DB - Token authentication

Open aimurphy opened this issue 4 months ago • 1 comments

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

aimurphy avatar Sep 25 '25 12:09 aimurphy

HI, do I need a driver in a pom.xml if setting up a docker compose connection to Astra even if I do not want to connect via a Java client? I mean does the astra.conf need a java driver withoput a maven dependency via jhar without a maven project? Thanks

ENate avatar Nov 24 '25 13:11 ENate