crypto.fips Migration (DEP0093)

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/nodejs/userland-migrations/llms.txt

Use this file to discover all available pages before exploring further.

​

What It Does

• Reading crypto.fips → crypto.getFips()
• Writing crypto.fips = value → crypto.setFips(value)
• Import statements to include getFips and setFips

​

Usage

npx codemod nodejs/crypto-fips-to-getFips

​

Examples

​

Reading FIPS Mode Status

import crypto from "node:crypto";
import { fips } from "node:crypto";

// Using crypto.fips
crypto.fips;
fips;

import crypto from "node:crypto";
import { getFips, setFips } from "node:crypto";

// Using crypto.getFips()
crypto.getFips();
getFips();

​

Enabling FIPS Mode

import crypto from "node:crypto";
import { fips } from "node:crypto";

// Using crypto.fips = true
crypto.fips = true;
fips = true;

import crypto from "node:crypto";
import { getFips, setFips } from "node:crypto";

// Using crypto.setFips(true)
crypto.setFips(true);
setFips(true);

​

Disabling FIPS Mode

import crypto from "node:crypto";
import { fips } from "node:crypto";

// Using crypto.fips = false
crypto.fips = false;
fips = false;

import crypto from "node:crypto";
import { getFips, setFips } from "node:crypto";

// Using crypto.setFips(false)
crypto.setFips(false);
setFips(false);

​

What is FIPS Mode?

• Only FIPS-approved cryptographic algorithms are available
• Node.js must be built with FIPS support
• Useful for applications requiring government-standard cryptography

​

Why Migrate?

• Provides explicit method calls for better code clarity
• Aligns with Node.js API conventions
• Enables better error handling
• Ensures compatibility with future Node.js versions

​

Common Usage Patterns

​

Check and Enable FIPS

import { getFips, setFips } from 'node:crypto';

if (!getFips()) {
  try {
    setFips(true);
    console.log('FIPS mode enabled');
  } catch (err) {
    console.error('Failed to enable FIPS mode:', err);
  }
}

​

Conditional FIPS Mode

import { setFips } from 'node:crypto';

if (process.env.ENABLE_FIPS === 'true') {
  setFips(true);
}

​

Deprecation Reference

​

Related APIs

• crypto.getFips() - Returns the current FIPS mode status (boolean)
• crypto.setFips(bool) - Enables or disables FIPS mode
• Node.js must be compiled with --openssl-fips for FIPS support