### Description

The [Get API key information API](https://www.elastic.co/guide/en/elasticsearch/reference/master/security-api-get-api-key.html) can currently filter the returned keys by:
 * key id/name
 * keys owned by the calling user
 * keys owned by other users, by `realm_name` and `username`

Irrespective of the filtering used, both invalidated and expired (but not yet deleted) keys will be included in the response.
In the response, keys have the `invalidated` boolean property, as well as the `expiration` property that contains the UNIX timestamp past of which the key is no longer valid for authentication.

I propose we introduce a way for the API to support retrieving:
* only valid API keys (not return invalidated keys) - using a boolean request parameter
* keys not expired before a certain timestamp - using a timestamp parameter that defaults to "now" - also note that keys' experiation date is always checked against the local node's clock
x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ApiKeyServiceTests.java
assertEquals(new HashSet<>(newKeyRoles), new HashSet<>(actualKeyRoles));
            }
            if (changeMetadata == false) {
                assertEquals(oldApiKeyDoc.metadataFlattened, updatedApiKeyDoc.metadataFlattened);
            } else {
                assertEquals(newMetadata, XContentHelper.convertToMap(updatedApiKeyDoc.metadataFlattened, true, XContentType.JSON).v2());
            }
            assertEquals(newAuthentication.getEffectiveSubject().getUser().principal(), updatedApiKeyDoc.creator.get("principal"));
            assertEquals(newAuthentication.getEffectiveSubject().getUser().fullName(), updatedApiKeyDoc.creator.get("full_name"));
            assertEquals(newAuthentication.getEffectiveSubject().getUser().email(), updatedApiKeyDoc.creator.get("email"));
            assertEquals(newAuthentication.getEffectiveSubject().getUser().metadata(), updatedApiKeyDoc.creator.get("metadata"));
            final RealmRef realm = newAuthentication.getEffectiveSubject().getRealm();
            assertEquals(realm.getName(), updatedApiKeyDoc.creator.get("realm"));
            assertEquals(realm.getType(), updatedApiKeyDoc.creator.get("realm_type"));
            if (realm.getDomain() != null) {
                @SuppressWarnings("unchecked")
                final var actualRealmDomain = RealmDomain.fromXContent(
                    XContentHelper.mapToXContentParser(
                        XContentParserConfiguration.EMPTY,
                        (Map<String, Object>) updatedApiKeyDoc.creator.get("realm_domain")
                    )
                );
                assertEquals(realm.getDomain(), actualRealmDomain);
            } else {
                assertFalse(updatedApiKeyDoc.creator.containsKey("realm_domain"));
            }
        }
    }
    public void testApiKeyDocDeserializationWithNullValues() throws IOException {
        final String apiKeyDocumentSource = """