Modulo NestJS per la gestione IP List Cloudflare

Prima di iniziare

1. Creare un account Cloudflare
2. Scegliere il Dominio da utilizzare
3. Manage Account > Configuration > List > Create List
4. Account API tokens > Create Token > Create Custom Token (Permission: Account > Account WAF > Edit, Account > Account Filter List > Edit)
5. Salvare il token API senza scadenza
6. Domains > Scegliere il dominio da utilizzare
7. Andare nella categoria Security > Security Rules > Create rule > Custom Rules
8. Nome: , Field: <IP Source Address , is in, scegli la lista creata prima>, Action: Block
9. Salvare la regola

Installazione

npm install @liberstudio/cloudflare-list

Utilizzo

Configurazione

Nel file di configurazione del progetto, aggiungere il modulo all'import della configurazione:

import { CloudflareAttacksModule } from "@liberstudio/cloudflare-list";

@Module({
  imports: [
    CloudflareAttacksModule.forRoot({
      accountId: "<account_id>",
      listId: "<list_id>",
      apiToken: "<api_token>",
      comment: "<comment>",
      logPath: "<logPath>",
    }),
  ],
})
export class AppModule {}

Versione Asincrona con ConfigModule

import { CloudflareAttacksModule } from "@liberstudio/cloudflare-list";

@Module({
  imports: [
    CloudflareAttacksModule.forRootAsync({
      imports: [ConfigModule],
      inject: [ConfigService],
      useFactory: (config: ConfigService) => ({
        apiToken: config.getOrThrow<string>('CLOUDFLARE_API_TOKEN'),
        accountId: config.getOrThrow<string>('CLOUDFLARE_ACCOUNT_ID'),
        listId: config.getOrThrow<string>('CLOUDFLARE_LIST_ID'),
        comment: config.get<string>('CLOUDFLARE_LIST_COMMENT') || 'Blocked',
        logPath: config.get<string>('CLOUDFLARE_LIST_LOG_PATH') || '/var/log/nestjs-attacks.log',
      })
    }),
  ],
})
export class AppModule {}

License

This project is licensed under the MIT License - see the LICENSE file for details.