encrypt_password | Commands | Teradata Data Mover - 17.10 - encrypt_password - Teradata Data Mover

Teradata® Data Mover User Guide

Product
Teradata Data Mover
Release Number
17.10
Release Date
June 2021
Content Type
User Guide
Publication ID
B035-4101-061K
Language
English (United States)

Purpose

The encrypt_password command creates an encrypted password from a password entered as a parameter on the command line, interactively, or through an XML file with a specific format. The generated password can then be used as a value for -source_password_encrypted or -target_password_encrypted when using the create and move commands.

Parameters

See Parameter Order.

dir
[Optional] Name of the directory in which Data Mover stores the encrypted password file. If you specify a directory, but not a filename, the command returns the encrypted password to standard output.
Example: /home/.dmauth
dm.rest.endpoint
[Optional] Enter a Data Mover REST server URL to overwrite the default value specified in the commandline.properties file in order to connect to a different REST server (and therefore a different daemon) at runtime.
https://dm-server1:1443/datamover
filename
[Optional] Name of an XML file to which Data Mover writes the encrypted password.
Example: apw.xml
password
Password to encrypt. If you do not enter a password on the command line, the command prompts you to enter a password interactively. When you enter a password interactively, your input is masked with a set number of asterisks, regardless of the length of the password.
Example: 73r4|)474

XML File Examples

To use an XML file with the encrypt_password command to generate an encrypted password, type datamove encrypt_password -f pw_parameters.xml.

For security purposes, specifying passwords as plaintext and storing them in a file is not recommended. You can create an encrypted password file such as pw_parameters.xml, without saving a plaintext password in the file. In the following example, no value is provided for the <password> tag.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dmGetEncryptedPassword xmlns="http://schemas.teradata.com/dataMover/v2009" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://schemas.teradata.com/unity/datamover.xsd">
    <password></password>
    <dir>/home/.dmauth</dir>
    <filename>apw.xml</filename>
</dmGetEncryptedPassword>
Data Mover prompts you to enter the password, then writes the encrypted password to /home/.dmauth/apw.xml.
/home/.dmauth/apw.xml
---------------------
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dmGetEncryptedPasswordOutput xmlns="http://schemas.teradata.com/dataMover/v2009"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    dmVersion="13.10.00.00"
    xsi:schemaLocation="http://schemas.teradata.com/unity/datamover.xsd">
    <password_encrypted>6683562fc7324fa8e49573c97ea9d4f76b6333f0749caa3a207c01f492231c8b</password_encrypted>
</dmGetEncryptedPasswordOutput>
The following example of a pw_parameters.xml file shows values for all tags.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dmGetEncryptedPassword xmlns="http://schemas.teradata.com/dataMover/v2009" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://schemas.teradata.com/unity/datamover.xsd">
    <password>73r4|)474</password>
    <dir>/home/.dmauth</dir>
    <filename>apw.xml</filename>
</dmGetEncryptedPassword>
Data Mover writes the encrypted password to /home/.dmauth/apw.xml.