@loopback/docs/site/apidocs/authentication.authenticationstrategy.authenticate.md

Documentation for LoopBack 4

---
lang: en
title: 'API docs: authentication.authenticationstrategy.authenticate'
keywords: LoopBack 4.0, LoopBack 4
sidebar: lb4_sidebar
permalink: /doc/en/lb4/apidocs.authentication.authenticationstrategy.authenticate.html
---

<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@loopback/authentication](./authentication.md) &gt; [AuthenticationStrategy](./authentication.authenticationstrategy.md) &gt; [authenticate](./authentication.authenticationstrategy.authenticate.md)

## AuthenticationStrategy.authenticate() method

The 'authenticate' method takes in a given request and returns a user profile which is an instance of 'UserProfile'. (A user profile is a minimal subset of a user object) If the user credentials are valid, this method should return a 'UserProfile' instance. If the user credentials are invalid, this method should throw an error If the user credentials are missing, this method should throw an error, or return 'undefined' and let the authentication action deal with it.

<b>Signature:</b>

```typescript
authenticate(request: Request): Promise<UserProfile | undefined>;
```

## Parameters

|  Parameter | Type | Description |
|  --- | --- | --- |
|  request | <code>Request</code> |  |

<b>Returns:</b>

`Promise<UserProfile | undefined>`