lcobucci
diff --git a/‎src/Builder.php
Lines changed: 5 additions & 1 deletion b/‎src/Builder.php
Lines changed: 5 additions & 1 deletion
diff --git a/‎test/unit/BuilderTest.php
Lines changed: 49 additions & 3 deletions b/‎test/unit/BuilderTest.php
Lines changed: 49 additions & 3 deletions
@@ -412,7 +412,11 @@ private function configureClaim($name, $value)
     public function withClaim($name, $value)
     {
         if (in_array($name, RegisteredClaims::ALL, true)) {
-            throw RegisteredClaimGiven::forClaim($name);
+            trigger_error('The use of the method "withClaim" is deprecated for registered claims. Please use dedicated method instead.', E_USER_DEPRECATED);
+        }
+
+        if ($name === RegisteredClaims::AUDIENCE) {
+            return $this->permittedFor($value);
         }
 
         return $this->configureClaim($name, $value);
 
@@ -564,15 +564,61 @@ public function withClaimMustKeepAFluentInterface()
     /**
      * @test
      *
+     * @param string $name
+     * @param mixed $value
+     * @param mixed $expected
+     *
      * @covers ::withClaim
      * @covers \Lcobucci\JWT\Token\RegisteredClaimGiven
+     *
+     * @dataProvider dataWithClaimDeprecationNotice
      */
-    public function withClaimShouldThrowExceptionWhenTryingToConfigureARegisteredClaim()
+    public function withClaimShouldSendDeprecationNoticeWhenTryingToConfigureARegisteredClaim($name, $value, $expected)
+    {
+        $key = $this->createMock(Key::class);
+        $signature = $this->createMock(Signature::class);
+        $signature
+            ->expects(static::once())
+            ->method('hash')
+            ->willReturn('--hash--')
+        ;
+
+        $signer = $this->createMock(Signer::class);
+        $signer
+            ->expects(static::once())
+            ->method('sign')
+            ->willReturn($signature)
+        ;
+
+
+
+        $this->expectDeprecation('The use of the method "withClaim" is deprecated for registered claims. Please use dedicated method instead.');
+
+        $token = $this
+            ->createBuilder()
+            ->withClaim($name, $value)
+            ->getToken($signer, $key)
+        ;
+
+        self::assertEquals($expected, $token->claims()->get($name));
+    }
+
+    public function dataWithClaimDeprecationNotice()
     {
-        $this->expectException(RegisteredClaimGiven::class);
+        $now = time();
+        $nowAsDate = new DateTimeImmutable('@' . $now);
+        $nowPlus1HourAsDate = $nowAsDate->modify('+1 hour');
 
-        $this->createBuilder()->withClaim('sub', 'me');
+        return [
+            ['sub', 'me', 'me'],
+            ['aud', 'him', ['him']],
+            ['jti', '0123456789ABCDEF', '0123456789ABCDEF'],
+            ['iss', 'you', 'you'],
+            ['exp', $nowPlus1HourAsDate->getTimestamp(), $nowPlus1HourAsDate->getTimestamp()],
+            ['iat', $now, $nowAsDate->getTimestamp()],
+            ['nbf', $now, $nowAsDate->getTimestamp()],
+        ];
     }
 
     /**
Original file line number	Diff line number	Diff line change
`@@ -412,7 +412,11 @@ private function configureClaim($name, $value)`
`412`	`412`	`public function withClaim($name, $value)`
`413`	`413`	`{`
`414`	`414`	`if (in_array($name, RegisteredClaims::ALL, true)) {`
`415`		`- throw RegisteredClaimGiven::forClaim($name);`
	`415`	`+ trigger_error('The use of the method "withClaim" is deprecated for registered claims. Please use dedicated method instead.', E_USER_DEPRECATED);`
	`416`	`+ }`
	`417`	`+`
	`418`	`+ if ($name === RegisteredClaims::AUDIENCE) {`
	`419`	`+ return $this->permittedFor($value);`
`416`	`420`	`}`
`417`	`421`
`418`	`422`	`return $this->configureClaim($name, $value);`