https://github.com/MatejLach/httpsig

Go library to sign & verify HTTP signatures, compatible with Mastodon/ActivityPub servers.
https://github.com/MatejLach/httpsig

activitypub golang http-signatures mastodon

Last synced: about 15 hours ago
JSON representation

Go library to sign & verify HTTP signatures, compatible with Mastodon/ActivityPub servers.

• Host: GitHub
• URL: https://github.com/MatejLach/httpsig
• Owner: MatejLach
• License: agpl-3.0
• Created: 2024-09-13T12:20:32.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-11-24T14:57:54.000Z (3 months ago)
• Last Synced: 2025-02-09T05:30:12.404Z (1 day ago)
• Topics: activitypub, golang, http-signatures, mastodon
• Language: Go
• Homepage: https://pkg.go.dev/github.com/MatejLach/httpsig
• Size: 18.6 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# httpsig

`httpsig` is a Go library allowing everyone to easily add Mastodon/ActivityPub-compatible HTTP signature to any HTTP request as well 

as verify the validity of a request's signature originating from an ActivityPub server.  

## Usage

[![Go Reference](https://pkg.go.dev/badge/github.com/MatejLach/httpsig.svg)](https://pkg.go.dev/github.com/MatejLach/httpsig)

### Signing requests

```go

package main

import (

	//...

	

	"github.com/MatejLach/httpsig"

)

func main() {

	// ...

	req, err := http.NewRequest(http.MethodGet, fmt.Sprintf("%s/user/me", server.URL), nil)

	if err != nil {

		// error handling

	}

	reqActorPubKeyId, err := url.Parse(fmt.Sprintf("%s/user/me", server.URL))

	if err != nil {

		// error handling

	}

	err = httpsig.SignRequest(context.Background(), req, reqActorPubKeyId, privateKeyPem.String())

	if err != nil {

		// error handling

	}

}

```

### Verifying requests

```go

package main

import (

	//...

	

	"github.com/MatejLach/httpsig"

)

func main() {

	// ...

	validSignature, err := httpsig.ReqHasValidSignature(context.Background(), req, "", true)

	if err != nil { 

		// error handling

	}

}

```

See the test suite for a more complete example. 

## Contributing

Pull requests and bug reports are welcome.