// ============================================================
    // User Agent Configuration
    // ============================================================

    /** Prefix for Fess crawler user agent string. */
    public static final String CRAWLING_USER_AGENT_PREFIX = "Mozilla/5.0 (compatible; Fess/";

    /** Suffix for Fess crawler user agent string with bot information URL. */

                + "<start_urls>https://example.com</start_urls>" + "</globalparams></config></eef>";

        parser.parse(new InputSource(new StringReader(xmlWithUserAgent)));

        parser.getWebConfig().ifPresent(config -> {
            assertEquals("custom-agent", config.getUserAgent());

    @Size(max = 10)
    public String searchUseBrowserLocale;

    /** SSO type (none, oic, saml, spnego, entraid). */
    @Size(max = 100)
    public String ssoType;

    /** User agent string for crawling operations. */
    @Size(max = 1000)
    public String crawlingUserAgent;

    /** Notification message displayed on the advanced search page. */
    @Size(max = 3000)

        public Integer getQueryMaxLengthAsInteger() {
            return 1000;
        }

        @Override
        public String[] getSearchlogRequestHeadersAsArray() {
            return new String[] { "user-agent", "referer" };
        }

        @Override
        public boolean isLoggingSearchDocsEnabled() {
            return false;
        }

        @Override

     */
    public static WebApiManagerFactory getWebApiManagerFactory() {
        return getComponent(WEB_API_MANAGER_FACTORY);
    }

    /**
     * Gets the user agent helper component.
     * @return The user agent helper.
     */
    public static UserAgentHelper getUserAgentHelper() {
        return getComponent(USER_AGENT_HELPER);
    }

    /**
     * Gets the data store factory component.

                    appendJson("languages", entity.getLanguages(), buf).append(',');
                    appendJson("roles", entity.getRoles(), buf).append(',');
                    appendJson("user-agent", entity.getUserAgent(), buf).append(',');
                    appendJson("client-ip", entity.getClientIp(), buf).append(',');
                    appendJson("access-type", entity.getAccessType(), buf).append(',');

 *
 * <p>The parser handles the following GSA configuration elements:
 * <ul>
 * <li>Collections with good/bad URL patterns</li>
 * <li>Global parameters including start URLs and filtering rules</li>
 * <li>User agent settings</li>
 * <li>URL pattern matching with regular expressions and contains filters</li>
 * </ul>
 *
 */
public class GsaConfigParser extends DefaultHandler {

    /** Logger instance for this class. */

            searchLog.setReferer(StringUtils.abbreviate(context.request.getHeader("referer"), 1000));
            searchLog.setUserAgent(StringUtils.abbreviate(context.request.getHeader("user-agent"), 255));

            searchLog.setAccessType(determineAccessType(context.request.getAttribute(Constants.SEARCH_LOG_ACCESS_TYPE)));

**Step 1: Export GSA Configuration**

Export your GSA configuration as XML. A typical GSA configuration includes:
- Collections with URL patterns
- Start URLs and crawl rules
- User agent settings
- Good/bad URL patterns

**Step 2: Import via Fess Admin UI**

1. Log in to Fess Admin Console: `http://<fess-server>:8080/admin`
2. Navigate to **System > Backup**

            params.put("Virtual Host", e.getVirtualHost());
            params.put("Roles", e.getRoles() != null ? String.join(" ", e.getRoles()) : StringUtil.EMPTY);
            params.put("User Agent", e.getUserAgent());
            e.getSearchFieldLogList().stream().forEach(p -> {
                params.put(p.getFirst(), p.getSecond());
            });
            e.getRequestHeaderList().stream().forEach(p -> {