* creator of the problem, the general expectation is that the hint provides sufficient information to the user to
     * track the problem back to its origin. A concrete example for such a source hint can be the file path or URL from
     * which the settings were read.
     *
     * @return the hint about the source of the problem or an empty string if unknown, never {@code null}
     */
    @Nonnull
    String getSource();

    /**

        assertEquals(InstanceDefFactory.SESSION, customPagerCreator.getInstanceDef());
        assertEquals(AutoBindingDefFactory.NONE, customPagerCreator.getAutoBindingDef());
    }

    // Test inherited behavior from ComponentCreatorImpl
    public void test_getNamingConvention() {
        assertSame(namingConvention, pagerCreator.getNamingConvention());
    }

    // Test component name creation

        SMBUtil.writeInt8(this.sessionId, dst, dstIndex);
        dstIndex += 8;

        return dstIndex - start;
    }

    /**
     * Decode a transform header from byte array
     *
     * @param buffer
     *            buffer to decode from
     * @param bufferIndex
     *            offset in buffer
     * @return new transform header instance
     */

    /**
     * Constructs a new AbstractCrawlerClient.
     */
    public AbstractCrawlerClient() {
        // NOP
    }

    /**
     * Initializes the client with parameters from initParamMap.
     * Sets maxContentLength, accessTimeout, and maxCachedContentSize.
     */
    public void init() {
        // max content length

 * may never contain more than {@link Integer#MAX_VALUE} occurrences of any one element.
 *
 * <p>{@code Multiset} refines the specifications of several methods from {@code Collection}. It
 * also defines an additional query operation, {@link #count}, which returns the count of an
 * element. There are five new bulk-modification operations, for example {@link #add(Object, int)},

  static <K, V> ImmutableMap<K, V> fromEntries(Entry<K, V>... entries) {
    return fromEntryArray(entries.length, entries, /* throwIfDuplicateKeys= */ true);
  }

  /**
   * Creates an ImmutableMap from the first n entries in entryArray. This implementation may replace
   * the entries in entryArray with its own entry objects (though they will have the same key/value
   * contents), and may take ownership of entryArray.
   */

        assertArrayEquals(mic, p4.getMechanismListMIC(), "MIC should be parsed from tag [4]");

        // Tag [3]
        byte[] tokenTag3 = buildInitToken(new ASN1ObjectIdentifier[] { OID_KRB }, null, null, mic, false, null, null, null);
        NegTokenInit p3 = new NegTokenInit(tokenTag3);
        assertArrayEquals(mic, p3.getMechanismListMIC(), "MIC should be parsed from tag [3]");
    }

    @Test

# Advanced Security { #advanced-security }

## Additional Features { #additional-features }

There are some extra features to handle security apart from the ones covered in the [Tutorial - User Guide: Security](../../tutorial/security/index.md){.internal-link target=_blank}.

/// tip

The next sections are **not necessarily "advanced"**.

And it's possible that for your use case, the solution is in one of them.

///

Those details are implementation specific.

For OAuth2 they are just strings.

///

## Global view { #global-view }

First, let's quickly see the parts that change from the examples in the main **Tutorial - User Guide** for [OAuth2 with Password (and hashing), Bearer with JWT tokens](../../tutorial/security/oauth2-jwt.md){.internal-link target=_blank}. Now using OAuth2 scopes:

 * This client supports authentication, content retrieval, and metadata extraction from SMB files.
 * It handles file access, directory listing, and access control entries (ACEs) processing.
 * </p>
 *
 * <p>
 * The class provides methods to:
 * </p>
 * <ul>
 *   <li>Initialize the client with SMB authentication details.</li>
 *   <li>Retrieve content and metadata from SMB files.</li>