Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/danielchristianschroeter/bioidwebservice-photoverify-grpc-sample-in-go
Simple PhotoVerify gRPC Sample in Go for BioIDWebService
https://github.com/danielchristianschroeter/bioidwebservice-photoverify-grpc-sample-in-go
bioid face-recognition grpc liveness-detection photoverify
Last synced: about 1 month ago
JSON representation
Simple PhotoVerify gRPC Sample in Go for BioIDWebService
- Host: GitHub
- URL: https://github.com/danielchristianschroeter/bioidwebservice-photoverify-grpc-sample-in-go
- Owner: danielchristianschroeter
- Created: 2024-07-03T10:24:39.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-07-03T17:53:23.000Z (6 months ago)
- Last Synced: 2024-07-04T12:45:32.248Z (6 months ago)
- Topics: bioid, face-recognition, grpc, liveness-detection, photoverify
- Language: Go
- Homepage:
- Size: 509 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# BioIDWebService-PhotoVerify-gRPC-Sample-in-Go
This repository contains a very simple example command line implementation of the **[PhotoVerify gRPC API of the BioID WebService](https://developer.bioid.com/bws/grpc/photoverify)** in Go.
One reference image and one or two live images are required to perform a photoverify request.
## Requirements
Before you can use the PhotoVerify API, you need to create a BWS Client ID and key in the BWS Portal.
You can request trial access on https://bwsportal.bioid.com/register
## Usage
1. Build or download prebuild executable
2. Execute following command to perform a photo verify with two images:
```
.\BioIDWebService-PhotoVerify-gRPC-Sample-In-Go -BWSClientID -BWSKey -photo example_images\photo.jpg -image1 example_images\testimage1.jpg -image2 example_images\testimage2.jpg
```
Example Output:
```
Total execution time: 954.999ms
Verification Status: SUCCEEDED
Verification Errors: [error_code:"RejectedByPassiveLiveDetection" message:"At least one of the live images seem not to be recorded from a live person." error_code:"RejectedByPassiveLiveDetection" message:"At least one of the live images seem not to be recorded from a live person."]
Verification ImageProperties: [faces:{left_eye:{x:716.6898478956991 y:295.90328987385425} right_eye:{x:583.7671688344084 y:295.6642189519129} texture_liveness_score:0.36677824126349556} faces:{left_eye:{x:493.984682522074 y:253.9819667801256} right_eye:{x:382.02615043197886 y:250.22897896148734} texture_liveness_score:0.46766824192470974}]
Verification PhotoProperties:
Verification Level: NOT_RECOGNIZED
Verification Score: 0
Verification Live: false
Verification LivenessScore: 0.46766824192470974
```
### Available command line parameter
```
./BioIDWebService-PhotoVerify-gRPC-Sample-In-Go --help
-BWSClientID string
BioIDWebService ClientID
-BWSKey string
BioIDWebService Key
-image1 string
1st live image
-image2 string
2nd live image (optional)
-photo string
reference photo image
```
## Clone and build the project
```
$ git clone https://github.com/danielchristianschroeter/BioIDWebService-PhotoVerify-gRPC-Sample-In-Go
$ cd BioIDWebService-PhotoVerify-gRPC-Sample-In-Go
$ go build .
```
## Generate or Update Go Code from Protocol Buffers file (`.proto`) for BioID Web Service
## Prerequisites & Installation
1. Download Protocol Buffers
Download the Protocol Buffers binary from the Protocol Buffers GitHub releases page https://github.com/protocolbuffers/protobuf/releases.
2. Install Go Plugins for Protocol Buffers
Run the following commands to install the necessary Go plugins:
```
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
```
3. Generating Go Code
To generate the Go code (bws_grpc.pb.go and bws.pb.go) from your bws.proto file, execute the following command with the Protocol Buffers executable:
```
protoc --proto_path= \
--go_out= \
--go_opt=paths=source_relative \
--go-grpc_out= \
--go-grpc_opt=paths=source_relative \
```
Replace , , and with the actual paths relevant to your project.
Ensure the protoc binary directory is included in your system's PATH environment variable. If not, navigate to the extracted bin directory and execute protoc from there.
This command will generate bws_grpc.pb.go and bws.pb.go files in the specified output directory, with paths relative to the source directory.