-
-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Description
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