import org.lastaflute.web.response.JsonResponse;

import jakarta.annotation.Resource;

/**
 * API action for admin file authentication management.
 * Provides RESTful API endpoints for managing file authentication settings in the Fess search engine.
 * File authentication settings define access credentials and permissions for file-based crawling.
 *
 */
public class ApiAdminFileauthAction extends FessApiAdminAction {

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *

        // WEB-INF/env/suggest/lib
        appendJarFile(cpSeparator, buf, new File(servletContext.getRealPath("/WEB-INF/env/" + getExecuteType() + "/lib")),
                "WEB-INF" + File.separator + "env" + File.separator + getExecuteType() + File.separator + "lib" + File.separator);
        // WEB-INF/plugin
        appendJarFile(cpSeparator, buf, new File(servletContext.getRealPath("/WEB-INF/plugin")),

import javax.inject.Inject;
import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.StandardOpenOption;

public class PrecommitTask extends DefaultTask {

    @OutputFile
    public File getSuccessMarker() {
        return new File(getProjectLayout().getBuildDirectory().getAsFile().get(), "markers/" + this.getName());
    }

    @TaskAction
    public void writeMarker() throws IOException {

        assertTrue(protocolHelper.isFilePathProtocol("smb1://server/share"));
        assertTrue(protocolHelper.isFilePathProtocol("file:///path/to/file"));
        assertTrue(protocolHelper.isFilePathProtocol("file:/path/to/file"));
        assertTrue(protocolHelper.isFilePathProtocol("ftp://ftp.example.com/file"));
        assertTrue(protocolHelper.isFilePathProtocol("s3://bucket/path"));

        assertEquals(fileName, notifyInfo.getFileName());
    }

    @ParameterizedTest
    @DisplayName("Test decode with various file names")
    @CsvSource({ "a.txt", "very_long_filename_with_many_characters_to_test_buffer_handling.docx", "file with spaces.pdf", "文件.txt", // Unicode filename
            "file-with-special-chars!@#$%^&().bin" })
    void testDecodeWithVariousFileNames(String fileName) throws SMBProtocolDecodingException {

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *

  String checkstyleIdeConfig = "$rootDir/checkstyle_ide.xml"

  inputs.files(file(checkstyleConfig), file(checkstyleIdeFragment))
  outputs.files(file(checkstyleIdeConfig))

  doLast {
    // Create an IDE-specific checkstyle config by first copying the standard config
    Files.copy(
      Paths.get(file(checkstyleConfig).getPath()),
      Paths.get(file(checkstyleIdeConfig).getPath()),
      StandardCopyOption.REPLACE_EXISTING
    )

   *
   * {@snippet :
   * Optional<Number> optionalInt = (Optional) getSomeOptionalInt();
   * Number value = optionalInt.or(0.5); // fine
   *
   * FluentIterable<? extends Number> numbers = getSomeNumbers();
   * Optional<Number> first = (Optional) numbers.first();
   * Number value = first.or(0.5); // fine
   * }
   *
   * <p><b>Comparison to {@code java.util.Optional}:</b> this method is similar to Java 8's {@code

Because we are now declaring those scopes, they will show up in the API docs when you log-in/authorize.

And you will be able to select which scopes you want to give access to: `me` and `items`.

This is the same mechanism used when you give permissions while logging in with Facebook, Google, GitHub, etc:

<img src="/img/tutorial/security/image11.png">

## JWT token with scopes { #jwt-token-with-scopes }