CSIRO Permanent Identifiers for the Web

Content

• Purpose
• Management
• System Operations
• Creating a New Identifier
• Naming Policy

Purpose

The purpose of this website is to provide a secure, permanent URL re-direction service for web endpoints.

Web applications that deal with Linked Data often need to specify and use URLs that are very stable. They utilize services such as this one to ensure that applications using their URLs will always be re-directed to a working website. This website operates like a switchboard, connecting requests for information with the true location of the information on the Web. The switchboard can be reconfigured to point to a new location if the old location stops working. For more information on what is a PID and this service please see CSIRO Persistent Identifier Service

Management

Under development.

System Operations

This website operates in HTTPS-only mode to ensure end-to-end security. This means that it may be used for Linked Data applications that require high levels of security such as those found in the financial, medical, and public infrastructure sectors.

Creating a New Identifier

If you would like to add or update a permanent identifier of the form https://pid.csiro.au/..., the preferred procedure is to perform the following steps:

1. Fork the Repository for this system on Bitbucket.
2. Add or update a new redirect entry and commit your changes.
3. Submit a Pull Request for your changes.

The maintainers of this system will then act on that Pull Request and merge it into this system's content. You will then be able to see your changes in the repository and via resolution of the identifier you created or edited.

Suitable PR content

Please help out the maintainers of the service with the following in your Pull Requests:

• contact info in a README.md or .htaccess comment.
  • See this example of a good README file: w3id.org/dggs/ README
• Squash multiple commits into one commit before a pull request if appropriate.
  • here is information on squashing commits: How to Squash Commits in Git
• use descriptive commit messages. In particular, include your project name in the commit message. For those using the GitHub interface, please modify the default "Create/Update/Delete .htaccess" message.

You can also Request a PID

Naming Policy

There is no official policy on identifier names. The current practice is to claim a top-level directory name and add project specific second level identifiers. For instance, https://pid.csiro.au/PROJECT-ID/SUB-ID... There is no official list or policy for reserved identifiers. However, the administrators may deny requests for identifiers that are too generic, could cause confusion, are inappropriate or offensive, or otherwise may be needed for future service expansion.