https://github.com/wireapp/legalhold
Legal Hold service for Wire messenger
https://github.com/wireapp/legalhold
Last synced: 8 months ago
JSON representation
Legal Hold service for Wire messenger
- Host: GitHub
- URL: https://github.com/wireapp/legalhold
- Owner: wireapp
- Created: 2019-04-04T08:29:59.000Z (about 7 years ago)
- Default Branch: staging
- Last Pushed: 2025-03-12T15:03:32.000Z (about 1 year ago)
- Last Synced: 2025-03-12T16:22:09.644Z (about 1 year ago)
- Language: Java
- Size: 19.5 MB
- Stars: 1
- Watchers: 7
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
This is Legal Hold Service for Wire.
## Environment variables
- SERVICE_TOKEN: . Must be set to some random value (at least 16 alphanumeric chars)
- WIRE_API_HOST: . Your Wire Backend host. Default: https://prod-nginz-https.wire.com
- CORE_CRYPTO_PASSWORD: . Your MLS folder password
- DB_DRIVER: . Default: org.postgresql.Driver
- DB_URL: . Default: jdbc:postgresql://localhost/legalhold
- DB_USER:
- DB_PASSWORD:
## Build the code
docker build -t $DOCKER_USERNAME/legalhold .
## Prebuilt Docker images (public):
https://quay.io/repository/wire/legalhold?tab=tags
## Run docker container (example)
```
docker run \
-e DB_URL='jdbc:postgresql://localhost/legalhold' \
-e DB_USER='admin' \
-e DB_PASSWORD='s3cret' \
-e SERVICE_TOKEN='secr3t' \
-e CORE_CRYPTO_PASSWORD='secr3t' \
-p 80:8080 \
--name secure-hold --rm quay.io/wire/legalhold:1.0.4
```
## Docker Compose
```
docker compose up --build app
```
## Outbound traffic
- GET https://prod-nginz-https.wire.com/notifications
- GET https://prod-nginz-https.wire.com/legalhold/conversations
- GET https://prod-nginz-https.wire.com/users
## Endpoints that need to be accessible from Wire Server
- POST /initiate
- POST /confirm
- POST /remove
## Endpoints visible internally (port 8080)
- GET /metrics
- POST /authorize
- GET /index.html
- GET /devices.html
- GET /conv/{conversationId}
- GET /events/{conversationId}
- GET /status (com.wire.bots.hold.monitoring.StatusResource)
- GET /swagger (io.federecio.dropwizard.swagger.SwaggerResource)
- GET /swagger.{type:json|yaml} (io.swagger.jaxrs.listing.ApiListingResource)
## Database format (Events table)
EventId | Type | Time | Payload
------- | ----- | ----- | -------------
cba19d4f-1683-4999-8f88-674048919c8f | conversation.otr-message-add.asset-data | 2021-07-11 19:54:33.782647| {"eventId":"a6fb04dd-e281-11eb-8002-22000a0e7660","messageId":"baac4fdc-3ad1-4402-aaa9-b2ae1bf60080","conversationId":"0c7b391e-737e-471c-8f0c-f0a1b4f40308","clientId":"1c07cb700248848d","userId":"cf65f307-5c00-4afc-911b-f6b91bcc0921","time":"2021-07-11T19:53:24.495Z","assetId":"3-1-e1f4bbed-8f84-4cd1-8b3d-5c1d652a5568","assetToken":"","otrKey":"KhgsmyM2paiMIR7HnNjwubWjSKocSCcM0P/qoTYJJfo=","sha256":"zzHz/1iqMkdU8B3eU7b5EB4aXNdJiLFSfzw9Lee8QOc="}
9ab4f996-3c33-4c4b-9872-628dccebacb6 | conversation.otr-message-add.image-preview | 2021-07-11 19:54:33.772223 | {"eventId":"a6fb04dd-e281-11eb-8002-22000a0e7660","messageId":"baac4fdc-3ad1-4402-aaa9-b2ae1bf60080","conversationId":"0c7b391e-737e-471c-8f0c-f0a1b4f40308","clientId":"1c07cb700248848d","userId":"cf65f307-5c00-4afc-911b-f6b91bcc0921","time":"2021-07-11T19:53:24.495Z","mimeType":"image/png","size":2746,"name":"","width":500,"height":500}
92a067eb-70fe-4c4e-89f2-629af98590f9 | conversation.otr-message-add.new-text | 2021-07-11 19:54:33.618655 | {"eventId":"a6643b34-e281-11eb-8002-22000a0e7660","messageId":"1c7f70e8-342d-4aac-8d6e-aacd7babbfb2","conversationId":"0c7b391e-737e-471c-8f0c-f0a1b4f40308","clientId":"1c07cb700248848d","userId":"cf65f307-5c00-4afc-911b-f6b91bcc0921","time":"2021-07-11T19:53:23.508Z","expireAfterMillis":10000,"text":"https://s3-eu-west-1.amazonaws.com/linkpreview.html","mentions":[]}