Transmute
HomepagePlatformGithubOpenAPI Spec
  • Introduction
  • Platform Guide
    • Credentials
      • Excel Based Data Entry
      • PDF Download
      • Data Integrity Proof Deprecation
      • Quick Convert
    • Contacts
    • Presentations
    • Workflows
    • Template Marketplace
    • Adapter Marketplace
      • GitHub Adapter
      • Neo4j Adapter
    • Organization Profile
    • Members
    • Billing
  • Technical Documentation
    • Machine to Machine Applications
    • OpenAPI Specification
    • Getting Started Postman Collection
    • Decentralized Identifiers Endpoints
    • Verifiable Credentials Endpoints
    • DIDAuth Presentations
  • Learning Center
    • Credentials 101
    • Decentralized 101
    • Digital Signatures
    • Holders, Issuers, Verifiers, & Subjects
    • Verification, Validity, and Veracity Checks
    • Interoperability
    • Open Standards
    • Verifiable Data Registries
    • JSON-LD
    • Digital Wallets 101
Powered by GitBook
On this page
  • Installing the Adapter
  • Running the script
  • Running the Action
  • Credential Issued

Was this helpful?

  1. Platform Guide
  2. Adapter Marketplace

GitHub Adapter

Connect to Transmute platform from Github with ease by leveraging the GitHub Adapter

PreviousAdapter MarketplaceNextNeo4j Adapter

Last updated 9 months ago

Was this helpful?

This page will cover how to install the GitHub Adapter from the Transmute Adapter marketplace which you can find .

The adapter uses an open source template repository to connection to the Transmute platform with OAuth authentication. The repository can be found here:

Installing the Adapter

This section will cover getting up and running with the GitHub adapter, which allows you to issue a credential from a GitHub workflow.

This will take you to the details page for the adapter. Click on the the Install button. Your browser will automatically download a Github Adapter.zip file.

You will be shown a modal indicating the application has been created on the Transmute platform. Clicking on Uh, Okay? will close the modal. Clicking on Let's Go! will bring you to this documentation.

Running the script

Once these steps are complete, you can run the following commands to create a repository that holds the adapter. Note the $ character is to show a command and not the be included in the line to execute.

$ unzip Github\ Adapter.zip

This will extract a script.sh and .env file from the zip.

$ chmod +x script.sh
$ ./script.sh

Running the Action

This will create a new private repository under you Github account named my-project, which is pre-populated with the settings to be able to run a workflow to issue a credential calling the Transmute platform API. The script will end with opening the browser to the location of this repository.

To run the action to issue a credential, click on the Actions tab on the top of the repository.

On the actions page, click on the Issue Credential list item, then click the Run workflow dropdown. And click on the Run workflow button to trigger the action to issue the credential.

This will initialize a new action that will have a yellow spinning icon to indicate the workflow is running. Once the action is complete you should see the spinning yellow icon turn into a green check-mark.

Click on the Issue Credential text to see the details about the action that was run.

You can click on the issued-verifiable-credential artifact in order to download the credential that you issued. And example of what this should look like is displayed below.

{
  "@context": "https://www.w3.org/2018/credentials/v1",
  "type": [
    "VerifiableCredential"
  ],
  "issuer": "did:web:test.transmute.industries:organizations:org_pmybE9LVkDde9Jh7",
  "issuanceDate": "2023-01-10T14:49:39Z",
  "credentialSubject": {
    "id": "did:example:456"
  },
  "proof": {
    "type": "Ed25519Signature2018",
    "created": "2023-01-10T14:49:40Z",
    "verificationMethod": "did:web:test.transmute.industries:organizations:org_pmybE9LVkDde9Jh7#z6MkfJwuJniojSD6XmeQ3V9xkkaw6EZp53BnnMMUrQNxAGRM",
    "proofPurpose": "assertionMethod",
    "jws": "eyJhbGciOiJFZERTQSIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..IOyALSto5FQwa8HUxM2e8dYrT8rQG__v0rT4hxCnPTaXMRSFL8DGWbo0q3kcemP20US9e4V80zlXqsttl9ezBg"
  }
}

If you want to verify that your credential was issued, you can navigate to your list of credentials in the application to see the credential populated there.

Credential Issued

Congratulations on issuing your first credential with a workflow. See what other functionality we can help you unlock with GitHub workflows.

The next steps will require running commands on the command line. In Windows this means moving the downloaded Github Adapter.zip file to the Ubuntu file-system. You will also nee do the Github CLI tool gh installed. You can find instructions for how to install here: . You will also need to be logged in with the gh tool, instructions for how to do that can be found here: .

https://cli.github.com/manual/installation
https://docs.github.com/en/github-cli/github-cli/quickstart
here
https://github.com/transmute-industries/template-adapter-github
Mavigating to the GitHub Adapter
Github Adapter detail page
Adapter install confirmation modal
Adapter repository
Dispatch action
Issue credential action in progress
Issue credential action complete
Issue Credential artifact
Issued credential in application
Github Adapter detail page