apache/hadoop · error · SASTokenProviderException

Configured Fixed SAS Token is empty or null.

Error message

Configured Fixed SAS Token is empty or null.

What it means

Error "Configured Fixed SAS Token is empty or null." thrown in apache/hadoop.

Source

Thrown at hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/services/FixedSASTokenProvider.java:38

import java.io.IOException;

import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.azurebfs.contracts.exceptions.SASTokenProviderException;
import org.apache.hadoop.fs.azurebfs.extensions.SASTokenProvider;

/**
 * In house implementation of {@link SASTokenProvider} to use a fixed SAS token with ABFS.
 * Use this to avoid implementing a Custom Token Provider just to return fixed SAS.
 * Fixed SAS Token to be provided using the config "fs.azure.sas.fixed.token".
 */
public class FixedSASTokenProvider implements SASTokenProvider {
  private String fixedSASToken;

  public FixedSASTokenProvider(final String fixedSASToken) throws SASTokenProviderException {
    this.fixedSASToken = fixedSASToken;
    if (fixedSASToken == null || fixedSASToken.isEmpty()) {
      throw new SASTokenProviderException(
          "Configured Fixed SAS Token is empty or null.");
    }
  }

  @Override
  public void initialize(final Configuration configuration,
      final String accountName)
      throws IOException {
  }

  /**
   * Returns the fixed SAS Token configured.
   * @param account the name of the storage account.
   * @param fileSystem the name of the fileSystem.
   * @param path the file or directory path.
   * @param operation the operation to be performed on the path.
   * @return Fixed SAS Token
   * @throws IOException never

View on GitHub (pinned to 2add963021)

Solutions

1. Set the fixed SAS token configuration (fs.azure.sas.fixed.token) to a valid non-empty SAS string.
2. Remove the fixed token configuration to use another auth mechanism.

When it happens

Trigger: The fixed SAS token provider is selected but the configured token is null or empty.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/9a7aba620f260bf7. Report an issue: GitHub.