DLOG_FILE_TO_FTP: Troubleshooting @ in Email Usernames

Daniel Price1 min read
Industrial NetworkingOther ManufacturerTroubleshooting
Licensed PE Working through this on a live machine? A Maine-licensed engineer can take it from here — included with IMD hardware, by the hour for everything else. Book an engineer

Problem Boundary

DLOG_FILE_TO_FTP must authenticate to an FTP server whose username is an email address. The username therefore contains an @ character, while the block's URL or credential string also uses @ as a separator. The evidence does not identify the block version, manufacturer, runtime, or exact failure response, so the affected implementation range remains unknown.

Why %40 Does Not Resolve the Username

The available implementation note states that generic %xx URL encoding and decoding was omitted because of memory and resource constraints. Therefore, do not assume that %40 will be decoded to @ by DLOG_FILE_TO_FTP.

Input representation Supported conclusion
@ Required inside the final email-style username, but conflicts with the credential separator.
%40 Not supported by the described implementation because generic percent decoding is absent.
% A proposed modified client translates this character to @ within the username.

Apply and Verify the Workaround

The proposed workaround is a modified FTP client that accepts a literal percent sign in place of the username's @, then changes that percent sign to @ before authentication. This is a special substitution, not standard %40 decoding.

USER%DOMAIN@PASSWORD

Internal username after substitution:
USER@DOMAIN
  1. Replace only the email username's @ with %; do not enter %40.
  2. Retain the block's credential separator before the password.
  3. Use a client version containing the percent-to-@ substitution.
  4. Test with non-production credentials and confirm that the FTP server receives the complete email-style username.

The supplied modification was explicitly described as untested. Treat it as a candidate workaround until login succeeds and file transfer completes. If the installed block lacks this modification, the evidence provides no supported configuration-only solution.

FAQ

Can DLOG_FILE_TO_FTP use %40 for an @ character?

Do not assume so. The described implementation does not include generic %xx decoding, so %40 is not a supported replacement based on the available evidence.

How do I use an email address as the FTP username?

With the proposed modified client, replace the username's @ with a single %. The client must then convert that character back to @ before authentication.

Is the percent-sign FTP workaround verified?

No. The modification was supplied as untested, so verify both successful authentication and completed file transfer before deploying it.

Back to blog