Resolving STEP 7 / TIA Portal License Key Not Found Errors

David Krause12 min read
SiemensTIA PortalTroubleshooting
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 Overview

Siemens STEP 7 V5.x and TIA Portal (V11 and later) rely on the SIMATIC Automation License Manager (ALM) to validate locally stored licenses before any project can be opened, compiled, or downloaded to a PLC. When the License Manager fails to enumerate or validate a previously working license key, the host engineering tool reports a generic "License key not found" or "The license for STEP 7/TIA Portal cannot be found" dialog and refuses to start the editor.

This symptom is reported in the field even when the license is intact on disk, when the License Manager displays the license as valid, and when the same user profile worked the day before. The most common trigger in legacy Windows environments (Windows 7 / Server 2008 R2 with classic user profiles) is accumulation of stale RSA query files under the user profile, which eventually breaks the local license enumeration cache.

Scope: This reference applies to STEP 7 V5.3 through V5.7, TIA Portal V11 through V18 (with V11 being the most frequently cited offender), and the matching Automation License Manager versions. The RSA cleanup procedure is OS-side and applies to Windows 7 / 8.1 / 10 / Server 2008 R2 / 2012 R2 installations.

Symptoms and Error Behavior

Engineers typically observe one or more of the following behaviors:

  • STEP 7 or TIA Portal refuses to start, reporting a missing license even though the License Manager UI shows the license present and valid.
  • The error appears for only one Windows user account; logging in as a different user finds the license without issue. This is the single strongest indicator of a corrupted per-user RSA cache.
  • After running a system maintenance utility such as CCleaner, disk defragmenter, or a registry cleaner, the License Manager UI continues to display the license as valid but the host application still cannot find it.
  • Repeated license query attempts are observed in the background; the RSA folder grows by hundreds or thousands of files per session.

Representative Error Strings

Application Error Text Trigger
STEP 7 V5.x "The license key for STEP 7 cannot be found." ALM enumeration failure
TIA Portal V11 "No valid license found. Close TIA Portal and check the Automation License Manager." ALM handshake failure
Automation License Manager License displays "valid" in the right pane but is not selectable by host Stale cache mismatch
Start Center "License not available" / "Demo mode only" Fallback to time-limited mode

Root Cause Analysis

Every time STEP 7, WinCC, or TIA Portal starts, it queries the License Manager through a local COM/RPC interface. The License Manager, in turn, validates the user's license tickets using Microsoft CryptoAPI RSA key containers located under the user profile:

C:\Users\<UserName>\AppData\Roaming\Microsoft\Crypto\RSA\

On legacy Windows XP paths this is exposed as:

C:\Documents and Settings\<UserName>\Application Data\Microsoft\Crypto\RSA\

Inside this folder, CryptoAPI creates a sub-folder whose name is a very long string beginning with the SID prefix S-1-5-21-. Each license query in STEP 7 / TIA Portal triggers the License Manager to create a temporary key container file inside that sub-folder. Over weeks or months, this folder accumulates thousands of files. Each file carries its own long cryptographic identifier. When the file count crosses a threshold (empirically observed above 1,500 files but the value depends on the OS and CryptoAPI build), CryptoAPI is unable to enumerate the container in time and the License Manager returns a key not found result to the host application, even though the license file on disk is valid.

Why one user and not another? The RSA cache is per-user (it lives under %APPDATA%). Other Windows accounts on the same machine each have their own RSA folder, which is why logging in as a different user "solves" the problem — but only for that account. The license file itself, located in %ProgramFiles%\Siemens\Automation\, is shared.

Secondary Causes

  • Registry cleaner / CCleaner over-reach: Tools such as CCleaner can purge CryptoAPI registry entries or orphan container metadata. The license still appears valid in the ALM UI because the UI reads from its own local cache, but the actual validation handshake fails.
  • Disk defragmentation across volumes: Defragmenting drives C: and D: does not move license files between volumes, but a third-party defragmenter that relocates files by filename pattern can in rare cases invalidate the protected storage location the License Manager expects.
  • Profile path length overflow: If the user profile path (including the long CryptoAPI container name) exceeds the Win32 MAX_PATH limit (260 characters), file creation silently fails, producing orphaned references that confuse subsequent enumeration.

Affected Versions

Product Versions Verified Affected Notes
STEP 7 V5.3, V5.4, V5.5, V5.6, V5.7 Classic STEP 7 administrative tools use the same ALM handshake
TIA Portal V11, V11 SP1, V11 SP2, V12, V13, V13 SP1, V14, V15, V15.1, V16, V17, V18 V11 most frequently cited; later versions reduced RSA write frequency but the path is unchanged
WinCC flexible 2008 SP2, 2008 SP3, 2008 SP4 Same ALM dependency
Automation License Manager V5.2, V5.3, V5.4, V6.0 ALM V6.0 introduced in TIA Portal V16
Windows OS Windows 7 SP1, Windows 8.1, Windows 10 (builds through 22H2), Server 2008 R2, Server 2012 R2 Windows 11 occasionally affected when user profile migrated from older OS

Solution Method 1 — RSA Folder Cleanup (Primary Fix)

This is the in-place remedy that resolves the issue without uninstalling any Siemens software. Run it as the affected user, not as Administrator, because the RSA folder is owned by the user profile.

Prerequisites

  • Close all instances of STEP 7, TIA Portal, WinCC, and the Automation License Manager.
  • Disable any real-time antivirus that locks the CryptoAPI container directory during scan (common with older Trend Micro, Kaspersky, and Sophos builds).
  • Confirm hidden files and folders are visible in Windows Explorer: View → Options → Show hidden files, folders, and drives.

Procedure

  1. Open Windows Explorer and navigate to the RSA folder for the affected user:
    • Windows 7: C:\Users\<UserName>\AppData\Roaming\Microsoft\Crypto\RSA\
    • Windows XP (legacy paths): C:\Documents and Settings\<UserName>\Application Data\Microsoft\Crypto\RSA\
  2. Locate the single sub-folder whose name begins with S-1-5-21-. This is the user's Security Identifier (SID) and is the only legitimate container. Do not delete the folder itself.
  3. Open that sub-folder and inspect the files inside. You will see filenames consisting of long GUID-like strings with no extension.
  4. Sort the folder by Date modified and delete every file whose modification date is older than 2 days. Do not delete files modified today or yesterday — these are in active use by the License Manager and possibly by other CryptoAPI consumers (S/MIME certificates, EFS, RDP credentials).
  5. Close Explorer. Restart the Automation License Manager from Start → Siemens Automation → Automation License Manager.
  6. Launch STEP 7 or TIA Portal and confirm the license is recognized.
Safe deletion threshold: The Siemens-issued remedy text states "more than 2 days old." This is conservative; in production environments where CryptoAPI is heavily used (Smart Card logon, EFS-encrypted files, BitLocker recovery keys), keep files from the last 7 days. If you are unsure, archive the folder to %TEMP%\RSA_BACKUP_<date> using robocopy /MOVE rather than DEL.

Verification

Open the Automation License Manager. The affected license should now appear with a green checkmark under "Validity". Launch TIA Portal — the start screen should load in licensed mode rather than falling back to the demo / time-limited banner.

Solution Method 2 — Reinstall SIMATIC License Manager

When Method 1 fails (license still not found, or ALM UI itself shows the license as missing), reinstall the Automation License Manager while preserving the actual license file. This rebuilds the CryptoAPI handshake without invalidating your purchased license.

Procedure

  1. Insert the original STEP 7 / TIA Portal installation medium or download the matching Automation License Manager installer from the Siemens Industry Online Support portal.
  2. Use Automation License Manager → Help → System Info to record the current license key fingerprint (license number, target PC ID).
  3. Close all Siemens applications. Use Control Panel → Programs and Features to uninstall SIMATIC Automation License Manager. Do not uninstall STEP 7 or TIA Portal.
  4. Reboot. Confirm that C:\Program Files\Siemens\Automation\ still contains your license file (typically AX NF ZZ <license_key>.bin on legacy builds, or .lic files on TIA Portal).
  5. Reinstall the Automation License Manager from the original installer. Accept all defaults.
  6. Reboot again. The License Manager will auto-discover the existing license file on first launch.
  7. If the license is still not visible, continue to Method 3 to transfer the license from the original USB stick or yellow floppy disk.
Preserve the TargetID: Licenses issued by Siemens are bound to the System ID / HostID of the target PC. If you performed the reinstall on the same machine, the HostID is unchanged and the existing license will be accepted automatically. If you are migrating to a new machine, you must return the old license and reissue it for the new HostID via Siemens License Web Siemens License Management.

Solution Method 3 — License Transfer from USB Stick or Floppy

When the local license file is genuinely missing or has been flagged as corrupted by the License Manager (status reads "invalid" or "defective" rather than "valid"), recover the license from the original physical media.

Procedure

  1. Insert the original Siemens USB license stick (typically red, marked "SIMATIC License") or the yellow floppy disk that shipped with the software.
  2. Open Automation License Manager.
  3. From the menu bar, choose License Key → Transfer.
  4. In the source pane, select the USB stick / floppy. In the destination pane, select the local hard drive target (typically C:\Program Files\Siemens\Automation).
  5. Click Transfer and enter the license number / CoL when prompted. This number is printed on the Certificate of License (CoL) sheet that accompanied the media.
  6. After transfer completes, remove the original media and store it in a secure location. The license is now bound to the local hard drive.
Yellow floppy media: For older STEP 7 V5.x licenses (pre-2008), the original media is a yellow 3.5" floppy disk. Most modern workstations no longer ship with a floppy drive; an external USB floppy drive is required. If the disk is unreadable, the license must be returned and reissued through Siemens Customer Support.

T-Online Side Effects Warning

The Siemens-issued remedy text explicitly warns that the RSA folder also contains credentials used by the legacy T-Online email and dialer client (T-Online is Deutsche Telekom's discontinued ISP product, but the CryptoAPI container it uses is shared). After cleaning the RSA folder, users have historically reported that T-Online login credentials need to be re-entered, or that auto-dial functionality stops working.

Recommended preventive step: Before deleting RSA files, open T-Online and export / record the saved login credentials, or migrate any active T-Online subscription to a modern email client that uses a separate credential store (Windows Credential Manager or Outlook profile). After the cleanup, verify that any saved dial-up or VPN entries are still functional.

Prevention and Best Practices

Once the license has been recovered, take these preventive measures to avoid recurrence:

  1. Schedule quarterly RSA hygiene. Add a Windows Scheduled Task (running as the affected user) that deletes RSA files older than 14 days. Sample PowerShell:
    $path = "$env:APPDATA\Microsoft\Crypto\RSA\*\*"
    Get-ChildItem $path -File -ErrorAction SilentlyContinue |
      Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-14) } |
      Remove-Item -Force -ErrorAction SilentlyContinue
  2. Exclude the CryptoAPI path from aggressive maintenance tools. Configure CCleaner, BleachBit, or similar utilities to exclude %APPDATA%\Microsoft\Crypto\RSA.
  3. Avoid defragmenters that move files by name pattern. Use the built-in Windows defragmenter or a vendor that respects NTFS change journals.
  4. Maintain a license archive. Keep the original USB stick, the yellow floppy, and the Certificate of License in a documented, fireproof location. Engineering stations fail; licenses need to be recoverable.
  5. Run STEP 7 / TIA Portal as the same Windows user that owns the license. Per-user licensing means that creating a new Windows account on the same machine forces a license retransfer.

Verification Matrix

Check Expected Result Failure Indication
ALM UI shows license with green check License validated Reinstall ALM (Method 2)
TIA Portal starts without demo banner License handshake succeeded Check %APPDATA% permissions
Project opens with full functionality All feature licenses present Verify option packages are licensed, not just base product
License survives Windows reboot Persistent license binding intact Check HostID has not changed (BIOS reset, motherboard replacement)
Other Windows users on same machine unaffected Per-user licensing working as designed Transfer license to that user's profile via Method 3

Troubleshooting Decision Flow

  1. License missing for all users on the machine? → License file itself is corrupt or missing → Method 3 (transfer from media).
  2. License missing for only one user? → Run Method 1 (RSA cleanup).
  3. Method 1 fails and license still missing? → Run Method 2 (ALM reinstall), then Method 3.
  4. License file present, ALM reinstalled, still missing? → HostID has changed (hardware swap). Return and reissue via Siemens License Web.
  5. Original USB / floppy unavailable? → Contact Siemens Customer Support with the Certificate of License number for license reissue.

FAQ

Why does TIA Portal say the license is not found even when Automation License Manager shows it as valid?

The Automation License Manager UI reads from a local cache and can show a license as "valid" while the underlying CryptoAPI handshake fails. The most common cause is a bloated RSA folder under %APPDATA%\Microsoft\Crypto\RSA with thousands of stale key container files. Delete RSA files older than two days, restart the ALM service, and relaunch TIA Portal.

Can I just delete the entire RSA folder?

No. The folder itself is required by CryptoAPI and other Windows subsystems (S/MIME, EFS, RDP credentials, legacy T-Online logins). Delete only the files inside the S-1-5-21- sub-folder, and only those older than two days. If you must delete the whole folder, back it up first with robocopy /MIR to a safe location.

What is the difference between a Siemens product key and a license key?

A Siemens license key is a per-PC, per-product activation file managed by the Automation License Manager, bound to the workstation's HostID. It is not the same as a Microsoft product key or 25-character activation code, which validates ownership of the underlying operating system or Office-style software. Siemens licenses are transferred, not typed in, and are physically delivered on USB sticks, floppy disks, or as downloaded .lic files.

Will reinstalling TIA Portal or STEP 7 delete my license?

Reinstalling STEP 7 or TIA Portal itself does not delete the license file in C:\Program Files\Siemens\Automation. However, uninstalling the Automation License Manager alone and then rebooting can temporarily make the license appear missing until ALM is reinstalled. Always uninstall ALM last and reinstall it first when recovering.

How do I recover a license when the original USB stick or floppy is lost?

Contact Siemens Customer Support with the Certificate of License (CoL) number printed on the original license document. Siemens can void the lost license and reissue a new one for the current HostID. There is a fee for lost-media reissues, and you must own the original CoL to qualify. Keep the CoL and the original physical media in documented, secure storage to avoid this scenario.

Back to blog