Skip to main content

ConsumePOP3

Description​

Consumes messages from Email Server using POP3 protocol. The raw-bytes of each received email message are written as contents of the FlowFile

Tags​

Consume, Email, Get, Ingest, Ingress, Message, POP3

Properties​

In the list below required Properties are shown with an asterisk (*). Other properties are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.

Display NameAPI NameDefault ValueAllowable ValuesDescription
Host Name *hostNetwork address of Email server (e.g., pop.gmail.com, imap.gmail.com . . .)

Supports Expression Language, using Environment variables.
Port *portNumeric value identifying Port of Email server (e.g., 993)

Supports Expression Language, using Environment variables.
Authorization Mode *authorization-modeUse Password
  • Use Password
  • Use OAuth2
How to authorize sending email on the user's behalf.
OAuth2 Access Token Provider *oauth2-access-token-providerController Service:
OAuth2AccessTokenProvider

Implementations:
StandardOauth2AccessTokenProvider
OAuth2 service that can provide access tokens.

This property is only considered if:
  • the property Authorization Mode has a value of oauth-based-authorization-mode
User Name *userUser Name used for authentication and authorization with Email server.

Supports Expression Language, using Environment variables.
Password *passwordPassword used for authentication and authorization with Email server.

Supports Expression Language, using Environment variables.

This property is only considered if:
  • the property Authorization Mode has a value of password-based-authorization-mode
Folder *folderINBOXEmail folder to retrieve messages from (e.g., INBOX)

Supports Expression Language, using Environment variables.
Fetch Size *fetch.size10Specify the maximum number of Messages to fetch per call to Email Server.

Supports Expression Language, using Environment variables.
Delete Messages *delete.messagesfalse
  • true
  • false
Specify whether mail messages should be deleted after retrieval.
Connection timeout *connection.timeout30 secThe amount of time to wait to connect to Email server

Supports Expression Language, using Environment variables.

Dynamic Properties​

This component does not support dynamic properties.

Relationships​

NameDescription
successAll messages that are the are successfully received from Email server and converted to FlowFiles are routed to this relationship

Reads Attributes​

This processor does not read attributes.

Writes Attributes​

This processor does not write attributes.

State Management​

This component does not store state.

Restricted​

This component is not restricted.

Input Requirement​

This component does not allow an incoming relationship.

System Resource Considerations​

This component does not specify system resource considerations.

See Also​