Extract Protected Container Files

This section describes how to extract container files that are protected with a password or require other types of credentials.

The following guidelines apply to specific file types.

• Lotus Notes NSF files. If you are running a Notes client with an active user connected to a Domino server, you must specify the user’s password as a credential regardless of whether the NSF files you are opening are protected. This enables File Content Extraction to access the Notes client and the Lotus Notes API. If the Notes client is not running with an active user, the password is not required.
• PST files. To open password-protected PST files that use high encryption (Microsoft Outlook 2003 only), you must use the MAPI-based PST reader (pstsr). The native PST reader (pstxsr) does not support files that use high encryption and returns the error KVERR_PasswordProtected if a PST file is encrypted with high encryption.

To supply credentials for opening protected container files

• In the Java API, call the addCredentialComponent method, on your session configuration, one or more times. Then call applyPendingCredentials. The method applyPendingCredentials replaces the list of credentials in the configuration with the credentials you have specified through addCredentialComponent and clears the pending list. (Therefore, note that calling applyPendingCredentials twice in succession would clear all credentials from the configuration).

  Copy

  // Add credentials to the list of pending credentials
  session.config().addCredentialComponent(CredentialKeyType.Password, "secret12345");
  session.config().addCredentialComponent(CredentialKeyType.Password, "secret67890");
              
  // Replace the credentials in the session configuration with those pending
  session.config().applyPendingCredentials();
  // The pending credentials list is now empty