AuthenticationManager provides mechanisms to validate DataONE authentication, when either a DataONE authentication token or X.509 Certificate is used.
obscuredValue of type "character" Is authentication disabled (obscured)?
AuthenticationManager(): Create an AuthenticationManager object
isAuthValid(): Verify authentication for a member node
getToken(): Get the value of the DataONE Authentication Token, if one exists
getCert(): Get the DataONE X.509 Certificate location
getAuthMethod(): Get the current valid authentication mechanism
getAuthSubject(): Get the authentication subject
getAuthExpires(): Get the expiration date of the current authentication method
isAuthExpired(): Check if the currently valid authentication method has reached the expiration time
obscureAuth(): Temporarily disable DataONE authentication
restoreAuth(): Restore authentication (after being disabled with obscureAuth)
showAuth(): Display all authentication information
getTokenInfo(): Display all authentication token information
getCertInfo(): Display all X.509 certificate information
Understanding how your identity is managed is important for working with DataONE, especially to avoid unexpected results. For example, depending your authorization status, searches may return only public records, or the full set of public and private records. Object and package retrievals might fail if some or all of the objects being retrieved are private. Creating or updating objects on DataONE nodes and reserving identifiers might fail if your authorization credentials are missing or expired.
DataONE version 2.0 provides an authentication mechanism known using JWT
Bearer tokens. For information about tokens and instructions for generating
a token for use with the dataone R package, view the overview document by
entering the command: 'vignette("v01-dataone-overview")'. DataONE authentication
tokens can be obtained by signing in to your DataONE account at https://search.dataone.org
and copying the token from your profile settings.
Additionally, DataONE API version 1.0 identifies you using CILogon-provided x509 certificates. DataONE partnered with CILogon to provide a widely-accessible certificate issuing mechanism that allows DataONE users to use existing trusted institutional and public accounts, but this method is deprecated and generally users should use JWT Bearer tokens as described above.
dataone() package description.