How to use Postman to match facial biometrics

When you enroll a person in a biometric authentication system, facial and fingerprint data are stored in a database. When you try to log into the system, this information is checked and compared with the previously collected data. If there is a match, access is allowed.

Despite the convenience of using biometrics, it is possible to fraud or manipulate the biometric sensors deliberately or inadvertently. Therefore, in addition to the comparison, it is extremely important to pay attention to the level of similarity between the matched biometrics, which will further ensure the security of authentication.

Below I will show you step-by-step how to use Postman and make the comparison between biometrics, using the BioPass ID feature set to make requests to the API.

1. Get the biometric API key via Postman

To perform operations on the biometrics API, you will need an access key that identifies you and provides access to the various functionalities of the system. To obtain one, see the previous article on enrolling an individual's facial biometrics via postman.

2. Extract the image templates in Postman

Since the biometrics platform uses only the "templates" taken from the images for the different biometric identification features, you need to perform, before the " face match" request, the template extraction operation from the face images you want to compare.

2.1 Configure the template extraction request in Postman

In the authorization header, select the type for "API Key". Then fill in the "Key" and "Value" fields respectively with Ocp-Apim-Subscription-Key and the value of the "API key", which is the access key mentioned above. You also need to select the "Header" option in the "Add to" field.

As the biometric API documentation shows, the url used for this call is https://api.biopassid.com/multibiometrics/extract and the method is "POST". All the fields mentioned are marked in red as shown in the image below:

Then fill in the parameters for the body of the request. Then select the "Body" section, mark the "raw" point and choose the JSON format from the drop-down list. JSON is a data formatting standard used to exchange information between systems because it is lightweight and easy for humans and computers to understand.

The body structure has the object "Extract", which represents the model extracted from the image, inside it the fields: "Type", which refers to the type of biometrics of the image provided, and can assume the values "FINGER" and "FACE", "Format", which determines the format of the model to be returned. The supported formats are: BIOPASS, ISO_IEC_2005_19794_2, ISO_IEC_2011_19794_2 and ANSI_INCITS_378. And the "Artifact" field, which receives the biometric image encoded in base64 string. 

Here is how the structure looks like in Postman:

Note that the "Type" parameter is getting the biometrics type "FACE", since we will be comparing facial images and for Format choose "BIOPASS". Regarding the "Artifact", where it is necessary to convert the image into base64, read step 5 of the tutorial Enrolling the facial biometrics of an individual via Postman. There you will learn what base64 is, why it is used, and how to convert the file.

To assist you in the operation, below is the partially filled in code. You just need to replace the contents of the "Artifact":

2. 2 Check the status of the operation 

After sending the request, you immediately receive a response of success or failure of the operation. In case of success, you can see the status "200 OK" and the body of the response with the object "Extract" and the field "Template", containing the template extracted from the image to be compared. Save the Template content in the notepad.

Now look at the example of a successful transaction:

If the operation is unsuccessful, we get as response status a numeric code starting with the numbers 4 or 5, along with the reason for the error. Here is an example:

To see all the descriptions and reasons for failures, please take a look at the biometric API documentation.

2.3 Extract the second image for comparison

Before you declare the extraction finished, it is important to remember that you need two images for comparison. Therefore, you need to perform two template extractions. Since the content of the first request is saved, repeat the same steps to extract the second image and also save the content in a notebook. Once this has been done, we can proceed to the comparison phase.

3. Compare images

To execute the operation that compares a person's facial biometrics, we keep the same configuration in the authorization header as in the previous request. We only change the url of the call to: https://api.biopassid.com/multibiometrics/match and the body of the request, where we add the templates extracted in the previous operations.

The request structure is composed of a "Match" object, which represents the correspondence between the compared images, and inside it the fields: "Type", "Format" (both explained in the template extraction transaction), "Artifact_A" and "Artifact_B", which receive the previously extracted contents, those saved in the notepad.

The response will be a JSON message with a Match object that has two fields: "ISGenuine", a boolean field that indicates through true or false responses whether the two biometrics are matching. And the "Score", a numeric field that indicates the similarity level of the two biometrics. Its value can range from 0 to 100.

The failure cases follow a similar pattern as the extraction request: a status code starting with the numbers 4 or 5, followed by the reason. The image below exemplifies an unsuccessful operation, where the reason is invalid JSON format.

4. Ready to use Postman? 

In this article, I have shown how biometric matching works with the BioPass ID feature set through the Postman platform to make the requests to the API.

An important process to avoid possible biometric fraud that ensures authentication security.

That's it for now and see you in the next article!

Translation: Thalita Ferreira

Don't miss out on our updates!

Subscribe to BioPass ID's newsletter and stay up-to-date with the world of biometrics and technology.

Thanks! We received your message!
Oops! Algo deu errado no envio do formulário.
Tente novamente em instantes.

Latest

Health 4.0: what it is, its benefits and challenges

Health 4.0 is data-driven and focused on personalizing patient care. This article explores the benefits and challenges of this approach.

Business
Contactless technology: learn about the innovation and its benefits

Contactless technology is growing at more than 180% annually, with strong adoption among the Brazilian public. Learn more about contactless payments.

Trend
Types of healthcare fraud: how biometrics can prevent them

Discover the most common healthcare frauds and how biometrics can help prevent these threats.

Privacy and Security
3 technology trends for the healthcare market

Technology helps improve both human and institutional health. Find out more about the emerging trends in the healthcare market.

Business
How to prevent fraud in public tenders with biometrics?

Fraud in public tenders can be prevented using biometrics, which brings more security and reliability to competitions. Find out more!

Business
How can BioPass ID APIs optimize healthcare services?

The use of APIs in healthcare simplifies processes and improves the quality of medical care. Learn more!

Business
How biometrics strengthens security in brazilian schools

The biggest benefit of using biometrics in schools is increased security. But there are many other benefits. Find out more here.

Business
Discover how BioPass ID prevents financial fraud

Fraudsters create new financial scams every day. Discover how BioPass ID protects companies and customer data from malicious actions.

Features
Telemedicine in Brazil: 5 advantages of using biometrics

The security and confidentiality of telemedicine in Brazil are concerns that are eliminated with the use of biometrics. Read more in the article.

Business
APIs for the financial market: how can they help your company?

APIs bring agility and savings to banks and fintechs. Discover other benefits that can also help financial institutions.

Features
3 APIs for the BioPass ID to streamline the education process

Biometric APIs can increase the security of educational institutions and improve operational efficiency and the student experience. Find out more.

Features
How to identify and prevent bank fraud

Learn how to identify bank fraud and how biometrics can help secure your information.

Business
Technology in Finance: trends and challenges

Artificial intelligence, open finance, and advanced biometrics promise to transform the financial marketplace. Learn more to stay ahead.

Business
5 security trends in education

Schools are facing complex security challenges and are trusting in technological innovation to solve these problems. Discover the top 5 trends.

Business
GDPL and biometrics: what to do to adapt

The GDPL has raised questions about the treatment and privacy of user data. Understand once and for all how it works.

Privacy and Security
5 benefits of using a Rest API

Rest APIs are ideal for cloud applications. Find out how to use them in your project.

Features
Cybersecurity: what it is and how to invest

Learn all about cybersecurity and find out how to protect your data online.

Privacy and Security
Liveness Detection: what’s the difference between passive and active?

The liveness detection technology may be used in a passive and active method to identify the proof of life authenticity of an image. Learn what’s the difference between them.

Features
ICAO standard: how to ensure biometric image quality

Quality biometric images meet ICAO standard to optimize identification and identity verification. Check out BioPass ID's solutions.

Features
Microservices architecture: what they are and their benefits

Learn what is the architecture model for software development using microservices and what are its advantages.

Business
How to speed up software developments with SDKs

The Face SDK, one of the BioPass ID SDKs, makes it possible to build and configure development platforms or applications quickly.

Features
Biometric boarding in Brazil: benefits and how it works

Meet the new technology that is breaking new ground in airport security.

News
Cloud Observability: what it is and how to use it

How to use web application monitoring and microservices in BioPass ID cloud-based biometrics platform. Check it out!

How to use Postman to evaluate the quality of a facial biometrics

A quick guide on how to use Postman, an API testing tool, to evaluate the quality of facial biometrics.

Features
How to detect spoofing in facial biometrics with Postman

Learn how to use the Postman tool to detect possible spoofing attacks on facial recognition biometric authentication systems.

Features
How to detect and anonymize facial biometrics via Postman

Check out how to detect and anonymize facial biometrics using the Postman platform and the BioPass ID feature set.

Features
Proof of Life: learn more about Liveness 2D V2

Biometrics, liveness and BioPass ID: how these technologies can boost your company and applications in the world of Biometrics as a Service.

ABIS: what is it, and how does it work

Biometrics, ABIS and BioPass ID. How these technologies can boost your company and applications in the world of Biometrics as a Service.

Liveness: the technology used by INSS to prevent fraud

Do you know Liveness? Learn how this tool can enhance your everyday security.

Why should you use biometrics in the cloud

Learn how the connection between Cloud Computing and Biometrics can increase the competitivity of companies in today's market.

Biometrics
How to use Postman to match facial biometrics

Understand the match between biometrics, using the BioPass ID feature set and the Postman platform to make API requests.

How to test a biometric API using Postman

Learn how to test a few CRUD operations of biometric API using Postman platform.

4 steps to integrate a BioPass ID biometric API

Learn how to implement and manage BioPass ID API packages in just 4 steps.

How to register a user's facial biometrics via Postman

Understand how to enroll facial biometrics through the Postman platform.

Kubernetes: the technology that enables cloud applications

Learn how BioPass ID uses Kubernetes, Containers, and cloud-native applications in its infrastructure.

Certify processes with the Analytics API

The Analytics API pack provides technology lenses that count people inside vehicles as well as in classrooms.

Online fraud: prevention tips with biometric validation

As our security advances, hackers also evolve their strategies. Do you know how to protect yourself from them?

Does biometrics contribute to trustworthy digital accounts?

As it seems, digital accounts are here to stay, but did biometrics contribute to this achievement?

What does the Roman Empire and biometrics have in common?

Did you know that the Roman Empire and biometrics have something in common? Yes, in concern for information security.

Data security: get better results with biometrics

Nowadays, with the amount of people connected, we care about the security of our data. Biometric correspondence can help with that.

Facial recognition is already being used in condos

Facial recognition technology is already being used in condos around the world as a way to ensure security and validate the entry of residents. Read this text to see how this process works.

How to prevent fraud using biometrics

Biometrics is an excellent security and validation tool, but you need to be aware of possible frauds. Read this text and learn more about it.

Learn the requirements of the ICAO standard (ISO 19794-5)

Learn about the characteristics of the icao standard for using facial recognition technology at airports.

How does facial biometrics help to keep your data safe?

Facial biometrics was one of the greatest security tools used in the pandemic.

What is the difference between API and SDK?

Understand the main differences between API and SDK, two technological tools often used by developers in applications.

What is cyber security?

Understand how cyber security works and how it can protect your data.

Do you really know how biometrics work?

Check out the news about the universe of biometrics, which develop and is integrated more and more in the daily life of the population.

What is an SDK?

SDK is a tool widely used in the technological environment. Learn more about it and learn how it can help you develop your applications.

How does facial biometrics work on public transportation

Facial biometrics has already been used in public transportation in some parts of the world. Learn how this technology can optimize the life of your users.

What is an API?

Understand what an API is, how it works, and where it runs in biometric applications.

Learn about multifactor authentication with multibiometrics

Understand how multi-factor authentication ensures full security and provides a good experience for your users.

Have you ever paid for your lunch with facial recognition?

As technology modernizes, new forms of access and payment are also created, and one of these possibilities is to pay with facial recognition.

Increase the security of your onboarding with Biometric Qualification

Onboarding is increasingly present in our lives, and as such, it is important to invest in increasing your security with biometric qualification.

Security flaws tendencies for 2022

From ransomware to identity management, learn about the main security flaws for 2022.

Using Facial Recognition in Videoconferences

Video conferencing is already part of our lives, but we need to pay attention to safety, imagine with the convenience of facial recognition?

Forget passwords, the future is passwordless

Who has never come across the event of forgetting a password? Forget it, the future is passwordless, contactless and frictionless.